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

package/dist/MimicClusterServerEngine.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"MimicClusterServerEngine.d.mts","names":[],"sources":["../src/MimicClusterServerEngine.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;cA0pBa;yBA3JwB,SAAA,CAAU,sBACrC,+BAA+B,aACtC,KAAA,CAAM,MACP,6BAEA,iBAAiB,gBAAgB,sBAAsB,QAAA,CAAS"}
+{"version":3,"file":"MimicClusterServerEngine.d.mts","names":[],"sources":["../src/MimicClusterServerEngine.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;cAyqBa;yBAjKwB,SAAA,CAAU,sBACrC,+BAA+B,aACtC,KAAA,CAAM,MACP,6BAEA,iBAAiB,gBAAgB,sBAAsB,QAAA,CAAS"}

package/dist/MimicClusterServerEngine.mjs

@@ -82,6 +82,7 @@ const MimicDocumentEntity = Entity.make("MimicDocument", [
 		success: SubmitResultSchema
 	}),
 	Rpc.make("GetSnapshot", { success: SnapshotResponseSchema }),
+	Rpc.make("GetTreeSnapshot", { success: Schema.Unknown }),
 	Rpc.make("Touch", { success: Schema.Void }),
 	Rpc.make("SetPresence", {
 		payload: {
@@ -176,6 +177,9 @@ const createEntityHandler = (config, coldStorage, hotStorage) => Effect.fn("clus
 		GetSnapshot: Effect.fn("cluster.document.snapshot.get")(function* () {
 			return instance.getSnapshot();
 		}),
+		GetTreeSnapshot: Effect.fn("cluster.document.tree-snapshot.get")(function* () {
+			return instance.toSnapshot();
+		}),
 		Touch: Effect.fn("cluster.document.touch")(function* () {
 			yield* instance.touch();
 		}),
@@ -303,6 +307,9 @@ const make = (config) => {
 			getSnapshot: (documentId) => Effect.gen(function* () {
 				return yield* makeClient(documentId).GetSnapshot(void 0).pipe(Effect.orDie);
 			}),
+			getTreeSnapshot: (documentId) => Effect.gen(function* () {
+				return yield* makeClient(documentId).GetTreeSnapshot(void 0).pipe(Effect.orDie);
+			}),
 			subscribe: (documentId) => Effect.gen(function* () {
 				const pubsub = yield* subscriptionStore.getOrCreatePubSub(documentId);
 				return Stream.fromPubSub(pubsub);

package/dist/MimicClusterServerEngine.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"MimicClusterServerEngine.mjs","names":["Metrics.documentsActive","Metrics.documentsEvicted","Metrics.storageIdleSnapshots","Metrics.presenceUpdates","Metrics.presenceActive","event: PresenceEvent","presences: Record<string, PresenceEntry>"],"sources":["../src/MimicClusterServerEngine.ts"],"sourcesContent":["/**\n * @voidhash/mimic-effect - MimicClusterServerEngine\n *\n * Clustered document management service using Effect Cluster for horizontal scaling.\n * Each document becomes a cluster Entity with automatic sharding, failover, and location-transparent routing.\n *\n * This is an alternative to MimicServerEngine for distributed deployments.\n */\nimport {\n  Context,\n  Duration,\n  Effect,\n  HashMap,\n  Layer,\n  Metric,\n  PubSub,\n  Ref,\n  Schedule,\n  Schema,\n  Stream,\n} from \"effect\";\nimport { Entity, Sharding } from \"@effect/cluster\";\nimport { Rpc } from \"@effect/rpc\";\nimport { type Primitive, type Transaction } from \"@voidhash/mimic\";\nimport type {\n  MimicClusterServerEngineConfig,\n  PresenceEntry,\n  PresenceEvent,\n  ResolvedClusterConfig,\n} from \"./Types\";\nimport type * as Protocol from \"./Protocol\";\nimport { ColdStorageTag, type ColdStorage } from \"./ColdStorage\";\nimport { HotStorageTag, type HotStorage } from \"./HotStorage\";\nimport { MimicAuthServiceTag } from \"./MimicAuthService\";\nimport { MimicServerEngineTag, type MimicServerEngine } from \"./MimicServerEngine\";\nimport {\n  DocumentInstance,\n  type DocumentInstance as DocumentInstanceInterface,\n} from \"./DocumentInstance\";\nimport * as Metrics from \"./Metrics\";\n\n// =============================================================================\n// Default Configuration\n// =============================================================================\n\nconst DEFAULT_MAX_IDLE_TIME = Duration.minutes(5);\nconst DEFAULT_MAX_TRANSACTION_HISTORY = 1000;\nconst DEFAULT_SNAPSHOT_INTERVAL = Duration.minutes(5);\nconst DEFAULT_SNAPSHOT_THRESHOLD = 100;\nconst DEFAULT_SNAPSHOT_IDLE_TIMEOUT = Duration.seconds(30);\nconst DEFAULT_SHARD_GROUP = \"mimic-documents\";\n\n// =============================================================================\n// RPC Schemas\n// =============================================================================\n\n/**\n * Schema for encoded transaction (wire format)\n */\nconst EncodedTransactionSchema = Schema.Struct({\n  id: Schema.String,\n  ops: Schema.Array(Schema.Unknown),\n});\n\n/**\n * Schema for submit result\n */\nconst SubmitResultSchema = Schema.Union(\n  Schema.Struct({\n    success: Schema.Literal(true),\n    version: Schema.Number,\n  }),\n  Schema.Struct({\n    success: Schema.Literal(false),\n    reason: Schema.String,\n  })\n);\n\n/**\n * Schema for snapshot response\n */\nconst SnapshotResponseSchema = Schema.Struct({\n  state: Schema.Unknown,\n  version: Schema.Number,\n});\n\n/**\n * Schema for presence entry\n */\nconst PresenceEntrySchema = Schema.Struct({\n  data: Schema.Unknown,\n  userId: Schema.optional(Schema.String),\n});\n\n/**\n * Schema for presence snapshot response\n */\nconst PresenceSnapshotResponseSchema = Schema.Struct({\n  presences: Schema.Record({ key: Schema.String, value: PresenceEntrySchema }),\n});\n\n/**\n * Schema for presence event\n */\nconst PresenceEventSchema = Schema.Union(\n  Schema.Struct({\n    type: Schema.Literal(\"presence_update\"),\n    id: Schema.String,\n    data: Schema.Unknown,\n    userId: Schema.optional(Schema.String),\n  }),\n  Schema.Struct({\n    type: Schema.Literal(\"presence_remove\"),\n    id: Schema.String,\n  })\n);\n\n/**\n * Schema for server message (for broadcasts)\n */\nconst ServerMessageSchema = Schema.Unknown;\n\n// =============================================================================\n// Mimic Document Entity Definition\n// =============================================================================\n\n/**\n * Define the Mimic Document Entity with its RPC protocol.\n * This entity handles document operations for a single documentId.\n */\nconst MimicDocumentEntity = Entity.make(\"MimicDocument\", [\n  // Submit a transaction\n  Rpc.make(\"Submit\", {\n    payload: { transaction: EncodedTransactionSchema },\n    success: SubmitResultSchema,\n  }),\n\n  // Get document snapshot\n  Rpc.make(\"GetSnapshot\", {\n    success: SnapshotResponseSchema,\n  }),\n\n  // Touch document to prevent idle GC\n  Rpc.make(\"Touch\", {\n    success: Schema.Void,\n  }),\n\n  // Set presence for a connection\n  Rpc.make(\"SetPresence\", {\n    payload: {\n      connectionId: Schema.String,\n      entry: PresenceEntrySchema,\n    },\n    success: Schema.Void,\n  }),\n\n  // Remove presence for a connection\n  Rpc.make(\"RemovePresence\", {\n    payload: { connectionId: Schema.String },\n    success: Schema.Void,\n  }),\n\n  // Get presence snapshot\n  Rpc.make(\"GetPresenceSnapshot\", {\n    success: PresenceSnapshotResponseSchema,\n  }),\n]);\n\n// =============================================================================\n// Entity State Types\n// =============================================================================\n\n/**\n * Entity state that wraps DocumentInstance and adds presence management\n */\ninterface EntityState<TSchema extends Primitive.AnyPrimitive> {\n  readonly instance: DocumentInstanceInterface<TSchema>;\n  readonly presences: HashMap.HashMap<string, PresenceEntry>;\n  readonly presencePubSub: PubSub.PubSub<PresenceEvent>;\n}\n\n// =============================================================================\n// Config Context Tag\n// =============================================================================\n\n/**\n * Context tag for cluster engine configuration\n */\nclass MimicClusterConfigTag extends Context.Tag(\n  \"@voidhash/mimic-effect/MimicClusterConfig\"\n)<MimicClusterConfigTag, ResolvedClusterConfig<Primitive.AnyPrimitive>>() {}\n\n// =============================================================================\n// Resolve Configuration\n// =============================================================================\n\nconst resolveClusterConfig = <TSchema extends Primitive.AnyPrimitive>(\n  config: MimicClusterServerEngineConfig<TSchema>\n): ResolvedClusterConfig<TSchema> => ({\n  schema: config.schema,\n  initial: config.initial,\n  presence: config.presence,\n  maxIdleTime: config.maxIdleTime\n    ? Duration.decode(config.maxIdleTime)\n    : DEFAULT_MAX_IDLE_TIME,\n  maxTransactionHistory:\n    config.maxTransactionHistory ?? DEFAULT_MAX_TRANSACTION_HISTORY,\n  snapshot: {\n    interval: config.snapshot?.interval\n      ? Duration.decode(config.snapshot.interval)\n      : DEFAULT_SNAPSHOT_INTERVAL,\n    transactionThreshold:\n      config.snapshot?.transactionThreshold ?? DEFAULT_SNAPSHOT_THRESHOLD,\n    idleTimeout: config.snapshot?.idleTimeout\n      ? Duration.decode(config.snapshot.idleTimeout)\n      : DEFAULT_SNAPSHOT_IDLE_TIMEOUT,\n  },\n  shardGroup: config.shardGroup ?? DEFAULT_SHARD_GROUP,\n});\n\n// =============================================================================\n// Helper to decode/encode transactions\n// =============================================================================\n\n/**\n * Decode an encoded transaction to a Transaction object\n */\nconst decodeTransaction = (\n  encoded: { id: string; ops: readonly unknown[] }\n): Transaction.Transaction => {\n  // Import Transaction dynamically to avoid circular deps\n  const { Transaction } = require(\"@voidhash/mimic\");\n  return Transaction.decode(encoded as Transaction.EncodedTransaction);\n};\n\n/**\n * Encode a Transaction to wire format\n */\nconst encodeTransaction = (\n  tx: Transaction.Transaction\n): { id: string; ops: readonly unknown[] } => {\n  const { Transaction } = require(\"@voidhash/mimic\");\n  return Transaction.encode(tx);\n};\n\n// =============================================================================\n// Entity Handler Factory\n// =============================================================================\n\n/**\n * Create the entity handler for MimicDocument\n */\nconst createEntityHandler = <TSchema extends Primitive.AnyPrimitive>(\n  config: ResolvedClusterConfig<TSchema>,\n  coldStorage: ColdStorage,\n  hotStorage: HotStorage\n) =>\n  Effect.fn(\"cluster.entity.handler.create\")(function* () {\n    // Get entity address to determine documentId\n    const address = yield* Entity.CurrentAddress;\n    const documentId = address.entityId;\n\n    // Create DocumentInstance (fatal if unavailable - entity cannot start)\n    const instance = yield* DocumentInstance.make(\n      documentId,\n      {\n        schema: config.schema,\n        initial: config.initial,\n        maxTransactionHistory: config.maxTransactionHistory,\n        snapshot: config.snapshot,\n      },\n      coldStorage,\n      hotStorage\n    ).pipe(Effect.orDie);\n\n    // Create presence PubSub and state ref\n    const presencePubSub = yield* PubSub.unbounded<PresenceEvent>();\n    const stateRef = yield* Ref.make<EntityState<TSchema>>({\n      instance,\n      presences: HashMap.empty(),\n      presencePubSub,\n    });\n\n    // Cleanup on entity finalization\n    yield* Effect.addFinalizer(() =>\n      Effect.fn(\"cluster.entity.finalize\")(function* () {\n        // Best effort save - don't fail shutdown if storage is unavailable\n        yield* Effect.catchAll(instance.saveSnapshot(), (e) =>\n          Effect.logError(\"Failed to save snapshot during entity finalization\", {\n            documentId,\n            error: e,\n          })\n        );\n        yield* Metric.incrementBy(Metrics.documentsActive, -1);\n        yield* Metric.increment(Metrics.documentsEvicted);\n        yield* Effect.logDebug(\"Entity finalized\", { documentId });\n      })()\n    );\n\n    // Start periodic snapshot fiber for this entity\n    const idleTimeoutMs = Duration.toMillis(config.snapshot.idleTimeout);\n    if (idleTimeoutMs > 0) {\n      const snapshotLoop = Effect.fn(\"cluster.entity.snapshot.loop\")(function* () {\n        const needs = yield* instance.needsSnapshot();\n        if (needs) {\n          yield* Effect.catchAll(instance.saveSnapshot(), (e) =>\n            Effect.logWarning(\"Periodic snapshot failed in cluster entity\", {\n              documentId,\n              error: e,\n            })\n          );\n          yield* Metric.increment(Metrics.storageIdleSnapshots);\n        }\n      });\n\n      // Run every idleTimeout\n      yield* snapshotLoop().pipe(\n        Effect.repeat(Schedule.spaced(config.snapshot.idleTimeout)),\n        Effect.fork\n      );\n    }\n\n    // Return RPC handlers\n    return {\n      Submit: Effect.fn(\"cluster.document.transaction.submit\")(function* ({\n        payload,\n      }) {\n        // Decode transaction\n        const transaction = decodeTransaction(payload.transaction);\n\n        // Use DocumentInstance's submit method, catching storage errors\n        return yield* instance.submit(transaction).pipe(\n          Effect.catchAll((error) =>\n            Effect.succeed({\n              success: false as const,\n              reason: `Storage error: ${String(error)}`,\n            })\n          )\n        );\n      }),\n\n      GetSnapshot: Effect.fn(\"cluster.document.snapshot.get\")(function* () {\n        return instance.getSnapshot();\n      }),\n\n      Touch: Effect.fn(\"cluster.document.touch\")(function* () {\n        yield* instance.touch();\n      }),\n\n      SetPresence: Effect.fn(\"cluster.presence.set\")(function* ({ payload }) {\n        const { connectionId, entry } = payload;\n\n        yield* Ref.update(stateRef, (s) => ({\n          ...s,\n          presences: HashMap.set(s.presences, connectionId, entry),\n        }));\n\n        yield* Metric.increment(Metrics.presenceUpdates);\n        yield* Metric.incrementBy(Metrics.presenceActive, 1);\n\n        const state = yield* Ref.get(stateRef);\n        const event: PresenceEvent = {\n          type: \"presence_update\",\n          id: connectionId,\n          data: entry.data,\n          userId: entry.userId,\n        };\n        yield* PubSub.publish(state.presencePubSub, event);\n      }),\n\n      RemovePresence: Effect.fn(\"cluster.presence.remove\")(function* ({\n        payload,\n      }) {\n        const { connectionId } = payload;\n        const state = yield* Ref.get(stateRef);\n\n        if (!HashMap.has(state.presences, connectionId)) {\n          return;\n        }\n\n        yield* Ref.update(stateRef, (s) => ({\n          ...s,\n          presences: HashMap.remove(s.presences, connectionId),\n        }));\n\n        yield* Metric.incrementBy(Metrics.presenceActive, -1);\n\n        const event: PresenceEvent = {\n          type: \"presence_remove\",\n          id: connectionId,\n        };\n        yield* PubSub.publish(state.presencePubSub, event);\n      }),\n\n      GetPresenceSnapshot: Effect.fn(\"cluster.presence.snapshot.get\")(\n        function* () {\n          const state = yield* Ref.get(stateRef);\n          const presences: Record<string, PresenceEntry> = {};\n          for (const [id, entry] of state.presences) {\n            presences[id] = entry;\n          }\n          return { presences };\n        }\n      ),\n    };\n  })();\n\n// =============================================================================\n// Subscription Store (for managing subscriptions at the gateway level)\n// =============================================================================\n\n/**\n * Store for managing document subscriptions\n * This is needed because cluster entities don't support streaming directly\n */\ninterface SubscriptionStore {\n  readonly getOrCreatePubSub: (\n    documentId: string\n  ) => Effect.Effect<PubSub.PubSub<Protocol.ServerMessage>>;\n  readonly getOrCreatePresencePubSub: (\n    documentId: string\n  ) => Effect.Effect<PubSub.PubSub<PresenceEvent>>;\n}\n\nclass SubscriptionStoreTag extends Context.Tag(\n  \"@voidhash/mimic-effect/SubscriptionStore\"\n)<SubscriptionStoreTag, SubscriptionStore>() {}\n\nconst subscriptionStoreLayer = Layer.effect(\n  SubscriptionStoreTag,\n  Effect.fn(\"cluster.subscriptions.layer.create\")(function* () {\n    const documentPubSubs = yield* Ref.make(\n      HashMap.empty<string, PubSub.PubSub<Protocol.ServerMessage>>()\n    );\n    const presencePubSubs = yield* Ref.make(\n      HashMap.empty<string, PubSub.PubSub<PresenceEvent>>()\n    );\n\n    return {\n      getOrCreatePubSub: Effect.fn(\n        \"cluster.subscriptions.pubsub.get-or-create\"\n      )(function* (documentId: string) {\n        const current = yield* Ref.get(documentPubSubs);\n        const existing = HashMap.get(current, documentId);\n        if (existing._tag === \"Some\") {\n          return existing.value;\n        }\n\n        const pubsub = yield* PubSub.unbounded<Protocol.ServerMessage>();\n        yield* Ref.update(documentPubSubs, (map) =>\n          HashMap.set(map, documentId, pubsub)\n        );\n        return pubsub;\n      }),\n\n      getOrCreatePresencePubSub: Effect.fn(\n        \"cluster.subscriptions.presence-pubsub.get-or-create\"\n      )(function* (documentId: string) {\n        const current = yield* Ref.get(presencePubSubs);\n        const existing = HashMap.get(current, documentId);\n        if (existing._tag === \"Some\") {\n          return existing.value;\n        }\n\n        const pubsub = yield* PubSub.unbounded<PresenceEvent>();\n        yield* Ref.update(presencePubSubs, (map) =>\n          HashMap.set(map, documentId, pubsub)\n        );\n        return pubsub;\n      }),\n    };\n  })()\n);\n\n// =============================================================================\n// Factory\n// =============================================================================\n\n/**\n * Create a MimicClusterServerEngine layer.\n *\n * This creates a clustered document management service using Effect Cluster.\n * Each document becomes a cluster Entity with automatic sharding and failover.\n *\n * @example\n * ```typescript\n * // 1. Create the engine\n * const Engine = MimicClusterServerEngine.make({\n *   schema: DocSchema,\n *   initial: { title: \"Untitled\" },\n *   presence: CursorPresence,\n *   maxIdleTime: \"5 minutes\",\n *   snapshot: { interval: \"5 minutes\", transactionThreshold: 100 },\n *   shardGroup: \"documents\",\n * })\n *\n * // 2. Create the WebSocket route\n * const MimicRoute = MimicServer.layerHttpLayerRouter({\n *   path: \"/mimic\",\n * })\n *\n * // 3. Wire together with cluster infrastructure\n * const MimicLive = MimicRoute.pipe(\n *   Layer.provide(Engine),\n *   Layer.provide(ColdStorage.S3.make(...)),\n *   Layer.provide(HotStorage.Redis.make(...)),\n *   Layer.provide(MimicAuthService.make(...)),\n *   Layer.provide(ClusterInfrastructure),\n * )\n * ```\n */\nexport const make = <TSchema extends Primitive.AnyPrimitive>(\n  config: MimicClusterServerEngineConfig<TSchema>\n): Layer.Layer<\n  MimicServerEngineTag,\n  never,\n  ColdStorageTag | HotStorageTag | MimicAuthServiceTag | Sharding.Sharding\n> => {\n  const resolvedConfig = resolveClusterConfig(config);\n\n  // Create config layer\n  const configLayer = Layer.succeed(\n    MimicClusterConfigTag,\n    resolvedConfig as ResolvedClusterConfig<Primitive.AnyPrimitive>\n  );\n\n  // Create entity layer that registers with sharding\n  const entityLayer = MimicDocumentEntity.toLayer(\n    Effect.gen(function* () {\n      const clusterConfig = yield* MimicClusterConfigTag;\n      const coldStorage = yield* ColdStorageTag;\n      const hotStorage = yield* HotStorageTag;\n\n      return yield* createEntityHandler(\n        clusterConfig as ResolvedClusterConfig<TSchema>,\n        coldStorage,\n        hotStorage\n      );\n    }),\n    {\n      maxIdleTime: resolvedConfig.maxIdleTime,\n      concurrency: 1, // Sequential message processing per document\n      mailboxCapacity: 4096,\n    }\n  );\n\n  // Create the engine service\n  const engineLayer = Layer.scoped(\n    MimicServerEngineTag,\n    Effect.gen(function* () {\n      // Get entity client maker\n      const makeClient = yield* MimicDocumentEntity.client;\n\n      // Get subscription store\n      const subscriptionStore = yield* SubscriptionStoreTag;\n\n      const engine: MimicServerEngine = {\n        submit: (documentId, transaction) =>\n          Effect.gen(function* () {\n            const client = makeClient(documentId);\n            const encodedTx = encodeTransaction(transaction);\n            const result = yield* client.Submit({\n              transaction: encodedTx as { id: string; ops: unknown[] },\n            }).pipe(\n              Effect.catchAll((error) =>\n                Effect.succeed({\n                  success: false as const,\n                  reason: `Cluster error: ${String(error)}`,\n                })\n              )\n            );\n\n            // Broadcast to local subscribers if success\n            if (result.success) {\n              const pubsub =\n                yield* subscriptionStore.getOrCreatePubSub(documentId);\n              yield* PubSub.publish(pubsub, {\n                type: \"transaction\",\n                transaction,\n                version: result.version,\n              } as Protocol.ServerMessage);\n            }\n\n            return result;\n          }),\n\n        getSnapshot: (documentId) =>\n          Effect.gen(function* () {\n            const client = makeClient(documentId);\n            return yield* client.GetSnapshot(undefined as void).pipe(Effect.orDie);\n          }),\n\n        subscribe: (documentId) =>\n          Effect.gen(function* () {\n            const pubsub =\n              yield* subscriptionStore.getOrCreatePubSub(documentId);\n            return Stream.fromPubSub(pubsub);\n          }),\n\n        touch: (documentId) =>\n          Effect.gen(function* () {\n            const client = makeClient(documentId);\n            yield* client.Touch(undefined as void).pipe(Effect.orDie);\n          }),\n\n        getPresenceSnapshot: (documentId) =>\n          Effect.gen(function* () {\n            const client = makeClient(documentId);\n            return yield* client.GetPresenceSnapshot(undefined as void).pipe(Effect.orDie);\n          }),\n\n        setPresence: (documentId, connectionId, entry) =>\n          Effect.gen(function* () {\n            const client = makeClient(documentId);\n            yield* client.SetPresence({ connectionId, entry }).pipe(Effect.orDie);\n\n            // Broadcast to local presence subscribers\n            const pubsub =\n              yield* subscriptionStore.getOrCreatePresencePubSub(documentId);\n            yield* PubSub.publish(pubsub, {\n              type: \"presence_update\",\n              id: connectionId,\n              data: entry.data,\n              userId: entry.userId,\n            });\n          }),\n\n        removePresence: (documentId, connectionId) =>\n          Effect.gen(function* () {\n            const client = makeClient(documentId);\n            yield* client.RemovePresence({ connectionId }).pipe(Effect.orDie);\n\n            // Broadcast to local presence subscribers\n            const pubsub =\n              yield* subscriptionStore.getOrCreatePresencePubSub(documentId);\n            yield* PubSub.publish(pubsub, {\n              type: \"presence_remove\",\n              id: connectionId,\n            });\n          }),\n\n        subscribePresence: (documentId) =>\n          Effect.gen(function* () {\n            const pubsub =\n              yield* subscriptionStore.getOrCreatePresencePubSub(documentId);\n            return Stream.fromPubSub(pubsub);\n          }),\n\n        config: resolvedConfig as ResolvedClusterConfig<Primitive.AnyPrimitive>,\n      };\n\n      return engine;\n    })\n  );\n\n  // Compose all layers\n  return Layer.mergeAll(entityLayer, engineLayer).pipe(\n    Layer.provideMerge(subscriptionStoreLayer),\n    Layer.provideMerge(configLayer)\n  );\n};\n\n// =============================================================================\n// Re-export namespace\n// =============================================================================\n\nexport const MimicClusterServerEngine = {\n  make,\n};\n"],"mappings":"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"}
+{"version":3,"file":"MimicClusterServerEngine.mjs","names":["Metrics.documentsActive","Metrics.documentsEvicted","Metrics.storageIdleSnapshots","Metrics.presenceUpdates","Metrics.presenceActive","event: PresenceEvent","presences: Record<string, PresenceEntry>"],"sources":["../src/MimicClusterServerEngine.ts"],"sourcesContent":["/**\n * @voidhash/mimic-effect - MimicClusterServerEngine\n *\n * Clustered document management service using Effect Cluster for horizontal scaling.\n * Each document becomes a cluster Entity with automatic sharding, failover, and location-transparent routing.\n *\n * This is an alternative to MimicServerEngine for distributed deployments.\n */\nimport {\n  Context,\n  Duration,\n  Effect,\n  HashMap,\n  Layer,\n  Metric,\n  PubSub,\n  Ref,\n  Schedule,\n  Schema,\n  Stream,\n} from \"effect\";\nimport { Entity, Sharding } from \"@effect/cluster\";\nimport { Rpc } from \"@effect/rpc\";\nimport { type Primitive, type Transaction } from \"@voidhash/mimic\";\nimport type {\n  MimicClusterServerEngineConfig,\n  PresenceEntry,\n  PresenceEvent,\n  ResolvedClusterConfig,\n} from \"./Types\";\nimport type * as Protocol from \"./Protocol\";\nimport { ColdStorageTag, type ColdStorage } from \"./ColdStorage\";\nimport { HotStorageTag, type HotStorage } from \"./HotStorage\";\nimport { MimicAuthServiceTag } from \"./MimicAuthService\";\nimport { MimicServerEngineTag, type MimicServerEngine } from \"./MimicServerEngine\";\nimport {\n  DocumentInstance,\n  type DocumentInstance as DocumentInstanceInterface,\n} from \"./DocumentInstance\";\nimport * as Metrics from \"./Metrics\";\n\n// =============================================================================\n// Default Configuration\n// =============================================================================\n\nconst DEFAULT_MAX_IDLE_TIME = Duration.minutes(5);\nconst DEFAULT_MAX_TRANSACTION_HISTORY = 1000;\nconst DEFAULT_SNAPSHOT_INTERVAL = Duration.minutes(5);\nconst DEFAULT_SNAPSHOT_THRESHOLD = 100;\nconst DEFAULT_SNAPSHOT_IDLE_TIMEOUT = Duration.seconds(30);\nconst DEFAULT_SHARD_GROUP = \"mimic-documents\";\n\n// =============================================================================\n// RPC Schemas\n// =============================================================================\n\n/**\n * Schema for encoded transaction (wire format)\n */\nconst EncodedTransactionSchema = Schema.Struct({\n  id: Schema.String,\n  ops: Schema.Array(Schema.Unknown),\n});\n\n/**\n * Schema for submit result\n */\nconst SubmitResultSchema = Schema.Union(\n  Schema.Struct({\n    success: Schema.Literal(true),\n    version: Schema.Number,\n  }),\n  Schema.Struct({\n    success: Schema.Literal(false),\n    reason: Schema.String,\n  })\n);\n\n/**\n * Schema for snapshot response\n */\nconst SnapshotResponseSchema = Schema.Struct({\n  state: Schema.Unknown,\n  version: Schema.Number,\n});\n\n/**\n * Schema for presence entry\n */\nconst PresenceEntrySchema = Schema.Struct({\n  data: Schema.Unknown,\n  userId: Schema.optional(Schema.String),\n});\n\n/**\n * Schema for presence snapshot response\n */\nconst PresenceSnapshotResponseSchema = Schema.Struct({\n  presences: Schema.Record({ key: Schema.String, value: PresenceEntrySchema }),\n});\n\n/**\n * Schema for presence event\n */\nconst PresenceEventSchema = Schema.Union(\n  Schema.Struct({\n    type: Schema.Literal(\"presence_update\"),\n    id: Schema.String,\n    data: Schema.Unknown,\n    userId: Schema.optional(Schema.String),\n  }),\n  Schema.Struct({\n    type: Schema.Literal(\"presence_remove\"),\n    id: Schema.String,\n  })\n);\n\n/**\n * Schema for server message (for broadcasts)\n */\nconst ServerMessageSchema = Schema.Unknown;\n\n// =============================================================================\n// Mimic Document Entity Definition\n// =============================================================================\n\n/**\n * Define the Mimic Document Entity with its RPC protocol.\n * This entity handles document operations for a single documentId.\n */\nconst MimicDocumentEntity = Entity.make(\"MimicDocument\", [\n  // Submit a transaction\n  Rpc.make(\"Submit\", {\n    payload: { transaction: EncodedTransactionSchema },\n    success: SubmitResultSchema,\n  }),\n\n  // Get document snapshot (flat state)\n  Rpc.make(\"GetSnapshot\", {\n    success: SnapshotResponseSchema,\n  }),\n\n  // Get tree-like snapshot for rendering\n  Rpc.make(\"GetTreeSnapshot\", {\n    success: Schema.Unknown,\n  }),\n\n  // Touch document to prevent idle GC\n  Rpc.make(\"Touch\", {\n    success: Schema.Void,\n  }),\n\n  // Set presence for a connection\n  Rpc.make(\"SetPresence\", {\n    payload: {\n      connectionId: Schema.String,\n      entry: PresenceEntrySchema,\n    },\n    success: Schema.Void,\n  }),\n\n  // Remove presence for a connection\n  Rpc.make(\"RemovePresence\", {\n    payload: { connectionId: Schema.String },\n    success: Schema.Void,\n  }),\n\n  // Get presence snapshot\n  Rpc.make(\"GetPresenceSnapshot\", {\n    success: PresenceSnapshotResponseSchema,\n  }),\n]);\n\n// =============================================================================\n// Entity State Types\n// =============================================================================\n\n/**\n * Entity state that wraps DocumentInstance and adds presence management\n */\ninterface EntityState<TSchema extends Primitive.AnyPrimitive> {\n  readonly instance: DocumentInstanceInterface<TSchema>;\n  readonly presences: HashMap.HashMap<string, PresenceEntry>;\n  readonly presencePubSub: PubSub.PubSub<PresenceEvent>;\n}\n\n// =============================================================================\n// Config Context Tag\n// =============================================================================\n\n/**\n * Context tag for cluster engine configuration\n */\nclass MimicClusterConfigTag extends Context.Tag(\n  \"@voidhash/mimic-effect/MimicClusterConfig\"\n)<MimicClusterConfigTag, ResolvedClusterConfig<Primitive.AnyPrimitive>>() {}\n\n// =============================================================================\n// Resolve Configuration\n// =============================================================================\n\nconst resolveClusterConfig = <TSchema extends Primitive.AnyPrimitive>(\n  config: MimicClusterServerEngineConfig<TSchema>\n): ResolvedClusterConfig<TSchema> => ({\n  schema: config.schema,\n  initial: config.initial,\n  presence: config.presence,\n  maxIdleTime: config.maxIdleTime\n    ? Duration.decode(config.maxIdleTime)\n    : DEFAULT_MAX_IDLE_TIME,\n  maxTransactionHistory:\n    config.maxTransactionHistory ?? DEFAULT_MAX_TRANSACTION_HISTORY,\n  snapshot: {\n    interval: config.snapshot?.interval\n      ? Duration.decode(config.snapshot.interval)\n      : DEFAULT_SNAPSHOT_INTERVAL,\n    transactionThreshold:\n      config.snapshot?.transactionThreshold ?? DEFAULT_SNAPSHOT_THRESHOLD,\n    idleTimeout: config.snapshot?.idleTimeout\n      ? Duration.decode(config.snapshot.idleTimeout)\n      : DEFAULT_SNAPSHOT_IDLE_TIMEOUT,\n  },\n  shardGroup: config.shardGroup ?? DEFAULT_SHARD_GROUP,\n});\n\n// =============================================================================\n// Helper to decode/encode transactions\n// =============================================================================\n\n/**\n * Decode an encoded transaction to a Transaction object\n */\nconst decodeTransaction = (\n  encoded: { id: string; ops: readonly unknown[] }\n): Transaction.Transaction => {\n  // Import Transaction dynamically to avoid circular deps\n  const { Transaction } = require(\"@voidhash/mimic\");\n  return Transaction.decode(encoded as Transaction.EncodedTransaction);\n};\n\n/**\n * Encode a Transaction to wire format\n */\nconst encodeTransaction = (\n  tx: Transaction.Transaction\n): { id: string; ops: readonly unknown[] } => {\n  const { Transaction } = require(\"@voidhash/mimic\");\n  return Transaction.encode(tx);\n};\n\n// =============================================================================\n// Entity Handler Factory\n// =============================================================================\n\n/**\n * Create the entity handler for MimicDocument\n */\nconst createEntityHandler = <TSchema extends Primitive.AnyPrimitive>(\n  config: ResolvedClusterConfig<TSchema>,\n  coldStorage: ColdStorage,\n  hotStorage: HotStorage\n) =>\n  Effect.fn(\"cluster.entity.handler.create\")(function* () {\n    // Get entity address to determine documentId\n    const address = yield* Entity.CurrentAddress;\n    const documentId = address.entityId;\n\n    // Create DocumentInstance (fatal if unavailable - entity cannot start)\n    const instance = yield* DocumentInstance.make(\n      documentId,\n      {\n        schema: config.schema,\n        initial: config.initial,\n        maxTransactionHistory: config.maxTransactionHistory,\n        snapshot: config.snapshot,\n      },\n      coldStorage,\n      hotStorage\n    ).pipe(Effect.orDie);\n\n    // Create presence PubSub and state ref\n    const presencePubSub = yield* PubSub.unbounded<PresenceEvent>();\n    const stateRef = yield* Ref.make<EntityState<TSchema>>({\n      instance,\n      presences: HashMap.empty(),\n      presencePubSub,\n    });\n\n    // Cleanup on entity finalization\n    yield* Effect.addFinalizer(() =>\n      Effect.fn(\"cluster.entity.finalize\")(function* () {\n        // Best effort save - don't fail shutdown if storage is unavailable\n        yield* Effect.catchAll(instance.saveSnapshot(), (e) =>\n          Effect.logError(\"Failed to save snapshot during entity finalization\", {\n            documentId,\n            error: e,\n          })\n        );\n        yield* Metric.incrementBy(Metrics.documentsActive, -1);\n        yield* Metric.increment(Metrics.documentsEvicted);\n        yield* Effect.logDebug(\"Entity finalized\", { documentId });\n      })()\n    );\n\n    // Start periodic snapshot fiber for this entity\n    const idleTimeoutMs = Duration.toMillis(config.snapshot.idleTimeout);\n    if (idleTimeoutMs > 0) {\n      const snapshotLoop = Effect.fn(\"cluster.entity.snapshot.loop\")(function* () {\n        const needs = yield* instance.needsSnapshot();\n        if (needs) {\n          yield* Effect.catchAll(instance.saveSnapshot(), (e) =>\n            Effect.logWarning(\"Periodic snapshot failed in cluster entity\", {\n              documentId,\n              error: e,\n            })\n          );\n          yield* Metric.increment(Metrics.storageIdleSnapshots);\n        }\n      });\n\n      // Run every idleTimeout\n      yield* snapshotLoop().pipe(\n        Effect.repeat(Schedule.spaced(config.snapshot.idleTimeout)),\n        Effect.fork\n      );\n    }\n\n    // Return RPC handlers\n    return {\n      Submit: Effect.fn(\"cluster.document.transaction.submit\")(function* ({\n        payload,\n      }) {\n        // Decode transaction\n        const transaction = decodeTransaction(payload.transaction);\n\n        // Use DocumentInstance's submit method, catching storage errors\n        return yield* instance.submit(transaction).pipe(\n          Effect.catchAll((error) =>\n            Effect.succeed({\n              success: false as const,\n              reason: `Storage error: ${String(error)}`,\n            })\n          )\n        );\n      }),\n\n      GetSnapshot: Effect.fn(\"cluster.document.snapshot.get\")(function* () {\n        return instance.getSnapshot();\n      }),\n\n      GetTreeSnapshot: Effect.fn(\"cluster.document.tree-snapshot.get\")(function* () {\n        return instance.toSnapshot();\n      }),\n\n      Touch: Effect.fn(\"cluster.document.touch\")(function* () {\n        yield* instance.touch();\n      }),\n\n      SetPresence: Effect.fn(\"cluster.presence.set\")(function* ({ payload }) {\n        const { connectionId, entry } = payload;\n\n        yield* Ref.update(stateRef, (s) => ({\n          ...s,\n          presences: HashMap.set(s.presences, connectionId, entry),\n        }));\n\n        yield* Metric.increment(Metrics.presenceUpdates);\n        yield* Metric.incrementBy(Metrics.presenceActive, 1);\n\n        const state = yield* Ref.get(stateRef);\n        const event: PresenceEvent = {\n          type: \"presence_update\",\n          id: connectionId,\n          data: entry.data,\n          userId: entry.userId,\n        };\n        yield* PubSub.publish(state.presencePubSub, event);\n      }),\n\n      RemovePresence: Effect.fn(\"cluster.presence.remove\")(function* ({\n        payload,\n      }) {\n        const { connectionId } = payload;\n        const state = yield* Ref.get(stateRef);\n\n        if (!HashMap.has(state.presences, connectionId)) {\n          return;\n        }\n\n        yield* Ref.update(stateRef, (s) => ({\n          ...s,\n          presences: HashMap.remove(s.presences, connectionId),\n        }));\n\n        yield* Metric.incrementBy(Metrics.presenceActive, -1);\n\n        const event: PresenceEvent = {\n          type: \"presence_remove\",\n          id: connectionId,\n        };\n        yield* PubSub.publish(state.presencePubSub, event);\n      }),\n\n      GetPresenceSnapshot: Effect.fn(\"cluster.presence.snapshot.get\")(\n        function* () {\n          const state = yield* Ref.get(stateRef);\n          const presences: Record<string, PresenceEntry> = {};\n          for (const [id, entry] of state.presences) {\n            presences[id] = entry;\n          }\n          return { presences };\n        }\n      ),\n    };\n  })();\n\n// =============================================================================\n// Subscription Store (for managing subscriptions at the gateway level)\n// =============================================================================\n\n/**\n * Store for managing document subscriptions\n * This is needed because cluster entities don't support streaming directly\n */\ninterface SubscriptionStore {\n  readonly getOrCreatePubSub: (\n    documentId: string\n  ) => Effect.Effect<PubSub.PubSub<Protocol.ServerMessage>>;\n  readonly getOrCreatePresencePubSub: (\n    documentId: string\n  ) => Effect.Effect<PubSub.PubSub<PresenceEvent>>;\n}\n\nclass SubscriptionStoreTag extends Context.Tag(\n  \"@voidhash/mimic-effect/SubscriptionStore\"\n)<SubscriptionStoreTag, SubscriptionStore>() {}\n\nconst subscriptionStoreLayer = Layer.effect(\n  SubscriptionStoreTag,\n  Effect.fn(\"cluster.subscriptions.layer.create\")(function* () {\n    const documentPubSubs = yield* Ref.make(\n      HashMap.empty<string, PubSub.PubSub<Protocol.ServerMessage>>()\n    );\n    const presencePubSubs = yield* Ref.make(\n      HashMap.empty<string, PubSub.PubSub<PresenceEvent>>()\n    );\n\n    return {\n      getOrCreatePubSub: Effect.fn(\n        \"cluster.subscriptions.pubsub.get-or-create\"\n      )(function* (documentId: string) {\n        const current = yield* Ref.get(documentPubSubs);\n        const existing = HashMap.get(current, documentId);\n        if (existing._tag === \"Some\") {\n          return existing.value;\n        }\n\n        const pubsub = yield* PubSub.unbounded<Protocol.ServerMessage>();\n        yield* Ref.update(documentPubSubs, (map) =>\n          HashMap.set(map, documentId, pubsub)\n        );\n        return pubsub;\n      }),\n\n      getOrCreatePresencePubSub: Effect.fn(\n        \"cluster.subscriptions.presence-pubsub.get-or-create\"\n      )(function* (documentId: string) {\n        const current = yield* Ref.get(presencePubSubs);\n        const existing = HashMap.get(current, documentId);\n        if (existing._tag === \"Some\") {\n          return existing.value;\n        }\n\n        const pubsub = yield* PubSub.unbounded<PresenceEvent>();\n        yield* Ref.update(presencePubSubs, (map) =>\n          HashMap.set(map, documentId, pubsub)\n        );\n        return pubsub;\n      }),\n    };\n  })()\n);\n\n// =============================================================================\n// Factory\n// =============================================================================\n\n/**\n * Create a MimicClusterServerEngine layer.\n *\n * This creates a clustered document management service using Effect Cluster.\n * Each document becomes a cluster Entity with automatic sharding and failover.\n *\n * @example\n * ```typescript\n * // 1. Create the engine\n * const Engine = MimicClusterServerEngine.make({\n *   schema: DocSchema,\n *   initial: { title: \"Untitled\" },\n *   presence: CursorPresence,\n *   maxIdleTime: \"5 minutes\",\n *   snapshot: { interval: \"5 minutes\", transactionThreshold: 100 },\n *   shardGroup: \"documents\",\n * })\n *\n * // 2. Create the WebSocket route\n * const MimicRoute = MimicServer.layerHttpLayerRouter({\n *   path: \"/mimic\",\n * })\n *\n * // 3. Wire together with cluster infrastructure\n * const MimicLive = MimicRoute.pipe(\n *   Layer.provide(Engine),\n *   Layer.provide(ColdStorage.S3.make(...)),\n *   Layer.provide(HotStorage.Redis.make(...)),\n *   Layer.provide(MimicAuthService.make(...)),\n *   Layer.provide(ClusterInfrastructure),\n * )\n * ```\n */\nexport const make = <TSchema extends Primitive.AnyPrimitive>(\n  config: MimicClusterServerEngineConfig<TSchema>\n): Layer.Layer<\n  MimicServerEngineTag,\n  never,\n  ColdStorageTag | HotStorageTag | MimicAuthServiceTag | Sharding.Sharding\n> => {\n  const resolvedConfig = resolveClusterConfig(config);\n\n  // Create config layer\n  const configLayer = Layer.succeed(\n    MimicClusterConfigTag,\n    resolvedConfig as ResolvedClusterConfig<Primitive.AnyPrimitive>\n  );\n\n  // Create entity layer that registers with sharding\n  const entityLayer = MimicDocumentEntity.toLayer(\n    Effect.gen(function* () {\n      const clusterConfig = yield* MimicClusterConfigTag;\n      const coldStorage = yield* ColdStorageTag;\n      const hotStorage = yield* HotStorageTag;\n\n      return yield* createEntityHandler(\n        clusterConfig as ResolvedClusterConfig<TSchema>,\n        coldStorage,\n        hotStorage\n      );\n    }),\n    {\n      maxIdleTime: resolvedConfig.maxIdleTime,\n      concurrency: 1, // Sequential message processing per document\n      mailboxCapacity: 4096,\n    }\n  );\n\n  // Create the engine service\n  const engineLayer = Layer.scoped(\n    MimicServerEngineTag,\n    Effect.gen(function* () {\n      // Get entity client maker\n      const makeClient = yield* MimicDocumentEntity.client;\n\n      // Get subscription store\n      const subscriptionStore = yield* SubscriptionStoreTag;\n\n      const engine: MimicServerEngine = {\n        submit: (documentId, transaction) =>\n          Effect.gen(function* () {\n            const client = makeClient(documentId);\n            const encodedTx = encodeTransaction(transaction);\n            const result = yield* client.Submit({\n              transaction: encodedTx as { id: string; ops: unknown[] },\n            }).pipe(\n              Effect.catchAll((error) =>\n                Effect.succeed({\n                  success: false as const,\n                  reason: `Cluster error: ${String(error)}`,\n                })\n              )\n            );\n\n            // Broadcast to local subscribers if success\n            if (result.success) {\n              const pubsub =\n                yield* subscriptionStore.getOrCreatePubSub(documentId);\n              yield* PubSub.publish(pubsub, {\n                type: \"transaction\",\n                transaction,\n                version: result.version,\n              } as Protocol.ServerMessage);\n            }\n\n            return result;\n          }),\n\n        getSnapshot: (documentId) =>\n          Effect.gen(function* () {\n            const client = makeClient(documentId);\n            return yield* client.GetSnapshot(undefined as void).pipe(Effect.orDie);\n          }),\n\n        getTreeSnapshot: (documentId) =>\n          Effect.gen(function* () {\n            const client = makeClient(documentId);\n            return yield* client.GetTreeSnapshot(undefined as void).pipe(Effect.orDie);\n          }),\n\n        subscribe: (documentId) =>\n          Effect.gen(function* () {\n            const pubsub =\n              yield* subscriptionStore.getOrCreatePubSub(documentId);\n            return Stream.fromPubSub(pubsub);\n          }),\n\n        touch: (documentId) =>\n          Effect.gen(function* () {\n            const client = makeClient(documentId);\n            yield* client.Touch(undefined as void).pipe(Effect.orDie);\n          }),\n\n        getPresenceSnapshot: (documentId) =>\n          Effect.gen(function* () {\n            const client = makeClient(documentId);\n            return yield* client.GetPresenceSnapshot(undefined as void).pipe(Effect.orDie);\n          }),\n\n        setPresence: (documentId, connectionId, entry) =>\n          Effect.gen(function* () {\n            const client = makeClient(documentId);\n            yield* client.SetPresence({ connectionId, entry }).pipe(Effect.orDie);\n\n            // Broadcast to local presence subscribers\n            const pubsub =\n              yield* subscriptionStore.getOrCreatePresencePubSub(documentId);\n            yield* PubSub.publish(pubsub, {\n              type: \"presence_update\",\n              id: connectionId,\n              data: entry.data,\n              userId: entry.userId,\n            });\n          }),\n\n        removePresence: (documentId, connectionId) =>\n          Effect.gen(function* () {\n            const client = makeClient(documentId);\n            yield* client.RemovePresence({ connectionId }).pipe(Effect.orDie);\n\n            // Broadcast to local presence subscribers\n            const pubsub =\n              yield* subscriptionStore.getOrCreatePresencePubSub(documentId);\n            yield* PubSub.publish(pubsub, {\n              type: \"presence_remove\",\n              id: connectionId,\n            });\n          }),\n\n        subscribePresence: (documentId) =>\n          Effect.gen(function* () {\n            const pubsub =\n              yield* subscriptionStore.getOrCreatePresencePubSub(documentId);\n            return Stream.fromPubSub(pubsub);\n          }),\n\n        config: resolvedConfig as ResolvedClusterConfig<Primitive.AnyPrimitive>,\n      };\n\n      return engine;\n    })\n  );\n\n  // Compose all layers\n  return Layer.mergeAll(entityLayer, engineLayer).pipe(\n    Layer.provideMerge(subscriptionStoreLayer),\n    Layer.provideMerge(configLayer)\n  );\n};\n\n// =============================================================================\n// Re-export namespace\n// =============================================================================\n\nexport const MimicClusterServerEngine = {\n  make,\n};\n"],"mappings":"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"}

package/dist/MimicServerEngine.cjs

@@ -151,6 +151,9 @@ const make = (config) => {
 			getSnapshot: (documentId) => effect.Effect.gen(function* () {
 				return (yield* getOrCreateDocument(documentId)).getSnapshot();
 			}),
+			getTreeSnapshot: (documentId) => effect.Effect.gen(function* () {
+				return (yield* getOrCreateDocument(documentId)).toSnapshot();
+			}),
 			subscribe: (documentId) => effect.Effect.gen(function* () {
 				const instance = yield* getOrCreateDocument(documentId);
 				return effect.Stream.fromPubSub(instance.pubsub);

package/dist/MimicServerEngine.d.cts

@@ -29,12 +29,20 @@ interface MimicServerEngine {
   readonly submit: (documentId: string, transaction: Transaction.Transaction) => Effect.Effect<SubmitResult, MimicServerEngineError>;
   /**
    * Get document snapshot (current state and version).
+   * Returns flat state format used for storage and synchronization.
    * May fail with MimicServerEngineError if storage is unavailable.
    */
   readonly getSnapshot: (documentId: string) => Effect.Effect<{
     state: unknown;
     version: number;
   }, MimicServerEngineError>;
+  /**
+   * Get tree-like snapshot for rendering.
+   * Returns a readonly structure where trees are converted from
+   * flat state to nested/hierarchical structure suitable for UI rendering.
+   * May fail with MimicServerEngineError if storage is unavailable.
+   */
+  readonly getTreeSnapshot: (documentId: string) => Effect.Effect<unknown, MimicServerEngineError>;
   /**
    * Subscribe to document broadcasts (transactions).
    * Returns a stream of server messages.

package/dist/MimicServerEngine.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"MimicServerEngine.d.cts","names":[],"sources":["../src/MimicServerEngine.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;AA0FqB,KAvCT,sBAAA,GAAyB,gBAuCT,GAvC4B,eAuC5B;;;;;;;AAoBjB,UA/CM,iBAAA,CA+CN;EACJ;;;;;EAgBA,SAAO,MAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,WAAA,EAxDG,WAAA,CAAY,WAwDf,EAAA,GAvDP,MAAA,CAAO,MAuDA,CAvDO,YAuDP,EAvDqB,sBAuDrB,CAAA;EAMoB;;;AACjC;gDAtDM,MAAA,CAAO;;;KAA4C;EA+D7C;AA+Tb;;;;;EArOE,SAAA,SAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,GA/IK,MAAA,CAAO,MA+IZ,CA/ImB,MAAA,CAAO,MA+I1B,CA/IiC,aA+IjC,EAAA,KAAA,EAAA,KAAA,CAAA,EA/IwE,sBA+IxE,EA/IgG,KAAA,CAAM,KA+ItG,CAAA;EAEA;;;EAHC,SAAM,KAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,GAzIiC,MAAA,CAAO,MAyIxC,CAAA,IAAA,EAAA,KAAA,CAAA;EAAK;;;wDAlIP,MAAA,CAAO,OAAO;;;;0EAQV,kBACJ,MAAA,CAAO;;;;yEAQP,MAAA,CAAO;;;;;sDAQP,MAAA,CAAO,OAAO,MAAA,CAAO,OAAO,qCAAqC,KAAA,CAAM;;;;;mBAM3D,eAAe,SAAA,CAAU;;cAC3C;;;;cASY,oBAAA,SAA6B,yBAAA;cA+T7B;;yBAxOwB,SAAA,CAAU,sBACrC,wBAAwB,aAC/B,KAAA,CAAM,MACP,6BAEA,iBAAiB,gBAAgB"}
+{"version":3,"file":"MimicServerEngine.d.cts","names":[],"sources":["../src/MimicServerEngine.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;AA2FO,KAxCK,sBAAA,GAAyB,gBAwCvB,GAxC0C,eAwC1C;;;;;;;AAsBO,UAlDJ,iBAAA,CAkDI;EAAd;;;;;EAyBc,SAAO,MAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,WAAA,EAnEX,WAAA,CAAY,WAmED,EAAA,GAlErB,MAAA,CAAO,MAkEc,CAlEP,YAkEO,EAlEO,sBAkEP,CAAA;EAA4C;;;;;EAOvE,SAAA,WAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,GAhEM,MAAA,CAAO,MAgEb,CAAA;;;KAhEyD;;AAyE1D;AAqUA;;;;EA7OU,SAAA,eAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,GAvJH,MAAA,CAAO,MAuJJ,CAAA,OAAA,EAvJoB,sBAuJpB,CAAA;EAER;;;;;;8CA/IK,MAAA,CAAO,OAAO,MAAA,CAAO,OAAO,8BAAuC,wBAAwB,KAAA,CAAM;;;;0CAK9D,MAAA,CAAO;;;;wDAO1C,MAAA,CAAO,OAAO;;;;0EAQV,kBACJ,MAAA,CAAO;;;;yEAQP,MAAA,CAAO;;;;;sDAQP,MAAA,CAAO,OAAO,MAAA,CAAO,OAAO,qCAAqC,KAAA,CAAM;;;;;mBAM3D,eAAe,SAAA,CAAU;;cAC3C;;;;cASY,oBAAA,SAA6B,yBAAA;cAqU7B;;yBA9OwB,SAAA,CAAU,sBACrC,wBAAwB,aAC/B,KAAA,CAAM,MACP,6BAEA,iBAAiB,gBAAgB"}

package/dist/MimicServerEngine.d.mts

@@ -29,12 +29,20 @@ interface MimicServerEngine {
   readonly submit: (documentId: string, transaction: Transaction.Transaction) => Effect.Effect<SubmitResult, MimicServerEngineError>;
   /**
    * Get document snapshot (current state and version).
+   * Returns flat state format used for storage and synchronization.
    * May fail with MimicServerEngineError if storage is unavailable.
    */
   readonly getSnapshot: (documentId: string) => Effect.Effect<{
     state: unknown;
     version: number;
   }, MimicServerEngineError>;
+  /**
+   * Get tree-like snapshot for rendering.
+   * Returns a readonly structure where trees are converted from
+   * flat state to nested/hierarchical structure suitable for UI rendering.
+   * May fail with MimicServerEngineError if storage is unavailable.
+   */
+  readonly getTreeSnapshot: (documentId: string) => Effect.Effect<unknown, MimicServerEngineError>;
   /**
    * Subscribe to document broadcasts (transactions).
    * Returns a stream of server messages.

package/dist/MimicServerEngine.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"MimicServerEngine.d.mts","names":[],"sources":["../src/MimicServerEngine.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;AA0FqB,KAvCT,sBAAA,GAAyB,gBAuCT,GAvC4B,eAuC5B;;;;;;;AAoBjB,UA/CM,iBAAA,CA+CN;EACJ;;;;;EAgBA,SAAO,MAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,WAAA,EAxDG,WAAA,CAAY,WAwDf,EAAA,GAvDP,MAAA,CAAO,MAuDA,CAvDO,YAuDP,EAvDqB,sBAuDrB,CAAA;EAMoB;;;AACjC;gDAtDM,MAAA,CAAO;;;KAA4C;EA+D7C;AA+Tb;;;;;EArOE,SAAA,SAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,GA/IK,MAAA,CAAO,MA+IZ,CA/ImB,MAAA,CAAO,MA+I1B,CA/IiC,aA+IjC,EAAA,KAAA,EAAA,KAAA,CAAA,EA/IwE,sBA+IxE,EA/IgG,KAAA,CAAM,KA+ItG,CAAA;EAEA;;;EAHC,SAAM,KAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,GAzIiC,MAAA,CAAO,MAyIxC,CAAA,IAAA,EAAA,KAAA,CAAA;EAAK;;;wDAlIP,MAAA,CAAO,OAAO;;;;0EAQV,kBACJ,MAAA,CAAO;;;;yEAQP,MAAA,CAAO;;;;;sDAQP,MAAA,CAAO,OAAO,MAAA,CAAO,OAAO,qCAAqC,KAAA,CAAM;;;;;mBAM3D,eAAe,SAAA,CAAU;;cAC3C;;;;cASY,oBAAA,SAA6B,yBAAA;cA+T7B;;yBAxOwB,SAAA,CAAU,sBACrC,wBAAwB,aAC/B,KAAA,CAAM,MACP,6BAEA,iBAAiB,gBAAgB"}
+{"version":3,"file":"MimicServerEngine.d.mts","names":[],"sources":["../src/MimicServerEngine.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;AA2FO,KAxCK,sBAAA,GAAyB,gBAwCvB,GAxC0C,eAwC1C;;;;;;;AAsBO,UAlDJ,iBAAA,CAkDI;EAAd;;;;;EAyBc,SAAO,MAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,WAAA,EAnEX,WAAA,CAAY,WAmED,EAAA,GAlErB,MAAA,CAAO,MAkEc,CAlEP,YAkEO,EAlEO,sBAkEP,CAAA;EAA4C;;;;;EAOvE,SAAA,WAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,GAhEM,MAAA,CAAO,MAgEb,CAAA;;;KAhEyD;;AAyE1D;AAqUA;;;;EA7OU,SAAA,eAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,GAvJH,MAAA,CAAO,MAuJJ,CAAA,OAAA,EAvJoB,sBAuJpB,CAAA;EAER;;;;;;8CA/IK,MAAA,CAAO,OAAO,MAAA,CAAO,OAAO,8BAAuC,wBAAwB,KAAA,CAAM;;;;0CAK9D,MAAA,CAAO;;;;wDAO1C,MAAA,CAAO,OAAO;;;;0EAQV,kBACJ,MAAA,CAAO;;;;yEAQP,MAAA,CAAO;;;;;sDAQP,MAAA,CAAO,OAAO,MAAA,CAAO,OAAO,qCAAqC,KAAA,CAAM;;;;;mBAM3D,eAAe,SAAA,CAAU;;cAC3C;;;;cASY,oBAAA,SAA6B,yBAAA;cAqU7B;;yBA9OwB,SAAA,CAAU,sBACrC,wBAAwB,aAC/B,KAAA,CAAM,MACP,6BAEA,iBAAiB,gBAAgB"}

package/dist/MimicServerEngine.mjs

@@ -151,6 +151,9 @@ const make = (config) => {
 			getSnapshot: (documentId) => Effect.gen(function* () {
 				return (yield* getOrCreateDocument(documentId)).getSnapshot();
 			}),
+			getTreeSnapshot: (documentId) => Effect.gen(function* () {
+				return (yield* getOrCreateDocument(documentId)).toSnapshot();
+			}),
 			subscribe: (documentId) => Effect.gen(function* () {
 				const instance = yield* getOrCreateDocument(documentId);
 				return Stream.fromPubSub(instance.pubsub);

package/dist/MimicServerEngine.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"MimicServerEngine.mjs","names":["Metrics.documentsEvicted","Metrics.documentsActive","Metrics.storageIdleSnapshots","presenceManagerLayer"],"sources":["../src/MimicServerEngine.ts"],"sourcesContent":["/**\n * @voidhash/mimic-effect - MimicServerEngine\n *\n * Core document management service for Mimic real-time collaboration.\n * Handles document lifecycle, storage, presence, and transaction processing.\n *\n * This is the engine layer - for WebSocket routes, use MimicServer.layerHttpLayerRouter().\n */\nimport {\n  Context,\n  Duration,\n  Effect,\n  HashMap,\n  Layer,\n  Metric,\n  Ref,\n  Schedule,\n  Scope,\n  Stream,\n} from \"effect\";\nimport type { Primitive, Transaction } from \"@voidhash/mimic\";\nimport type {\n  MimicServerEngineConfig,\n  PresenceEntry,\n  PresenceEvent,\n  PresenceSnapshot,\n  ResolvedConfig,\n} from \"./Types\";\nimport type * as Protocol from \"./Protocol\";\nimport { ColdStorageTag } from \"./ColdStorage\";\nimport { HotStorageTag } from \"./HotStorage\";\nimport { MimicAuthServiceTag } from \"./MimicAuthService\";\nimport {\n  DocumentInstance,\n  type SubmitResult,\n  type DocumentInstance as DocumentInstanceType,\n} from \"./DocumentInstance\";\nimport {\n  PresenceManagerTag,\n  layer as presenceManagerLayer,\n} from \"./PresenceManager\";\nimport * as Metrics from \"./Metrics\";\nimport type { ColdStorageError, HotStorageError } from \"./Errors\";\n\n// =============================================================================\n// Types\n// =============================================================================\n\n/**\n * Error type for MimicServerEngine operations\n */\nexport type MimicServerEngineError = ColdStorageError | HotStorageError;\n\n// =============================================================================\n// MimicServerEngine Interface\n// =============================================================================\n\n/**\n * MimicServerEngine service interface.\n *\n * Provides document management operations for Mimic collaboration.\n * Use MimicServer.layerHttpLayerRouter() to create WebSocket routes.\n */\nexport interface MimicServerEngine {\n  /**\n   * Submit a transaction to a document.\n   * Authorization is checked against the auth service.\n   * May fail with MimicServerEngineError if storage is unavailable.\n   */\n  readonly submit: (\n    documentId: string,\n    transaction: Transaction.Transaction\n  ) => Effect.Effect<SubmitResult, MimicServerEngineError>;\n\n  /**\n   * Get document snapshot (current state and version).\n   * May fail with MimicServerEngineError if storage is unavailable.\n   */\n  readonly getSnapshot: (\n    documentId: string\n  ) => Effect.Effect<{ state: unknown; version: number }, MimicServerEngineError>;\n\n  /**\n   * Subscribe to document broadcasts (transactions).\n   * Returns a stream of server messages.\n   * Requires a Scope for cleanup when the subscription ends.\n   * May fail with MimicServerEngineError if storage is unavailable.\n   */\n  readonly subscribe: (\n    documentId: string\n  ) => Effect.Effect<Stream.Stream<Protocol.ServerMessage, never, never>, MimicServerEngineError, Scope.Scope>;\n\n  /**\n   * Touch document to prevent idle garbage collection.\n   */\n  readonly touch: (documentId: string) => Effect.Effect<void, never>;\n\n  /**\n   * Get presence snapshot for a document.\n   */\n  readonly getPresenceSnapshot: (\n    documentId: string\n  ) => Effect.Effect<PresenceSnapshot, never>;\n\n  /**\n   * Set presence for a connection.\n   */\n  readonly setPresence: (\n    documentId: string,\n    connectionId: string,\n    entry: PresenceEntry\n  ) => Effect.Effect<void, never>;\n\n  /**\n   * Remove presence for a connection.\n   */\n  readonly removePresence: (\n    documentId: string,\n    connectionId: string\n  ) => Effect.Effect<void, never>;\n\n  /**\n   * Subscribe to presence events for a document.\n   * Requires a Scope for cleanup when the subscription ends.\n   */\n  readonly subscribePresence: (\n    documentId: string\n  ) => Effect.Effect<Stream.Stream<PresenceEvent, never, never>, never, Scope.Scope>;\n\n  /**\n   * Resolved engine configuration.\n   * Used by route layer to access schema, presence config, etc.\n   */\n  readonly config: ResolvedConfig<Primitive.AnyPrimitive>;\n}\n\n// =============================================================================\n// Context Tag\n// =============================================================================\n\n/**\n * Context tag for MimicServerEngine\n */\nexport class MimicServerEngineTag extends Context.Tag(\n  \"@voidhash/mimic-effect/MimicServerEngine\"\n)<MimicServerEngineTag, MimicServerEngine>() {}\n\n// =============================================================================\n// Default Configuration\n// =============================================================================\n\nconst DEFAULT_MAX_IDLE_TIME = Duration.minutes(5);\nconst DEFAULT_MAX_TRANSACTION_HISTORY = 1000;\nconst DEFAULT_SNAPSHOT_INTERVAL = Duration.minutes(5);\nconst DEFAULT_SNAPSHOT_THRESHOLD = 100;\nconst DEFAULT_SNAPSHOT_IDLE_TIMEOUT = Duration.seconds(30);\n\n/**\n * Resolve configuration with defaults\n */\nconst resolveConfig = <TSchema extends Primitive.AnyPrimitive>(\n  config: MimicServerEngineConfig<TSchema>\n): ResolvedConfig<TSchema> => ({\n  schema: config.schema,\n  initial: config.initial,\n  presence: config.presence,\n  maxIdleTime: config.maxIdleTime\n    ? Duration.decode(config.maxIdleTime)\n    : DEFAULT_MAX_IDLE_TIME,\n  maxTransactionHistory:\n    config.maxTransactionHistory ?? DEFAULT_MAX_TRANSACTION_HISTORY,\n  snapshot: {\n    interval: config.snapshot?.interval\n      ? Duration.decode(config.snapshot.interval)\n      : DEFAULT_SNAPSHOT_INTERVAL,\n    transactionThreshold:\n      config.snapshot?.transactionThreshold ?? DEFAULT_SNAPSHOT_THRESHOLD,\n    idleTimeout: config.snapshot?.idleTimeout\n      ? Duration.decode(config.snapshot.idleTimeout)\n      : DEFAULT_SNAPSHOT_IDLE_TIMEOUT,\n  },\n});\n\n// =============================================================================\n// Internal Types\n// =============================================================================\n\n/**\n * Store entry for a document instance with last activity time\n */\ninterface StoreEntry<TSchema extends Primitive.AnyPrimitive> {\n  readonly instance: DocumentInstanceType<TSchema>;\n  readonly lastActivityTime: Ref.Ref<number>;\n}\n\n// =============================================================================\n// Factory\n// =============================================================================\n\n/**\n * Create a MimicServerEngine layer.\n *\n * This creates the core document management service. To expose it via WebSocket,\n * use MimicServer.layerHttpLayerRouter().\n *\n * @example\n * ```typescript\n * // 1. Create the engine\n * const Engine = MimicServerEngine.make({\n *   schema: DocSchema,\n *   initial: { title: \"Untitled\" },\n *   presence: CursorPresence,\n *   maxIdleTime: \"5 minutes\",\n *   snapshot: { interval: \"5 minutes\", transactionThreshold: 100 },\n * })\n *\n * // 2. Create the WebSocket route\n * const MimicRoute = MimicServer.layerHttpLayerRouter({\n *   path: \"/mimic\",\n * })\n *\n * // 3. Wire together\n * const MimicLive = MimicRoute.pipe(\n *   Layer.provide(Engine),\n *   Layer.provide(ColdStorage.InMemory.make()),\n *   Layer.provide(HotStorage.InMemory.make()),\n *   Layer.provide(MimicAuthService.NoAuth.make()),\n * )\n * ```\n */\nexport const make = <TSchema extends Primitive.AnyPrimitive>(\n  config: MimicServerEngineConfig<TSchema>\n): Layer.Layer<\n  MimicServerEngineTag,\n  never,\n  ColdStorageTag | HotStorageTag | MimicAuthServiceTag\n> => {\n  const resolvedConfig = resolveConfig(config);\n\n  return Layer.scoped(\n    MimicServerEngineTag,\n    Effect.gen(function* () {\n      const coldStorage = yield* ColdStorageTag;\n      const hotStorage = yield* HotStorageTag;\n      const presenceManager = yield* PresenceManagerTag;\n\n      // Store: documentId -> StoreEntry\n      const store = yield* Ref.make(\n        HashMap.empty<string, StoreEntry<TSchema>>()\n      );\n\n      /**\n       * Get or create a document instance\n       */\n      const getOrCreateDocument = Effect.fn(\"engine.document.get-or-create\")(\n        function* (documentId: string) {\n          const current = yield* Ref.get(store);\n          const existing = HashMap.get(current, documentId);\n\n          if (existing._tag === \"Some\") {\n            // Update activity time\n            yield* Ref.set(existing.value.lastActivityTime, Date.now());\n            return existing.value.instance;\n          }\n\n          // Create new document instance\n          const instance = yield* DocumentInstance.make(\n            documentId,\n            {\n              schema: config.schema,\n              initial: config.initial,\n              maxTransactionHistory: resolvedConfig.maxTransactionHistory,\n              snapshot: resolvedConfig.snapshot,\n            },\n            coldStorage,\n            hotStorage\n          );\n\n          const lastActivityTime = yield* Ref.make(Date.now());\n\n          // Store it\n          yield* Ref.update(store, (map) =>\n            HashMap.set(map, documentId, { instance, lastActivityTime })\n          );\n\n          return instance;\n        }\n      );\n\n      /**\n       * Start background GC fiber\n       */\n      const startGCFiber = Effect.fn(\"engine.gc.start\")(function* () {\n        const gcLoop = Effect.fn(\"engine.gc.loop\")(function* () {\n          const current = yield* Ref.get(store);\n          const now = Date.now();\n          const maxIdleMs = Duration.toMillis(resolvedConfig.maxIdleTime);\n\n          for (const [documentId, entry] of current) {\n            const lastActivity = yield* Ref.get(entry.lastActivityTime);\n            if (now - lastActivity >= maxIdleMs) {\n              // Save final snapshot before eviction (best effort)\n              yield* Effect.catchAll(entry.instance.saveSnapshot(), (e) =>\n                Effect.logError(\"Failed to save snapshot during eviction\", {\n                  documentId,\n                  error: e,\n                })\n              );\n\n              // Remove from store\n              yield* Ref.update(store, (map) => HashMap.remove(map, documentId));\n\n              // Track eviction metrics\n              yield* Metric.increment(Metrics.documentsEvicted);\n              yield* Metric.incrementBy(Metrics.documentsActive, -1);\n\n              yield* Effect.logInfo(\"Document evicted due to idle timeout\", {\n                documentId,\n              });\n            }\n          }\n        });\n\n        // Run GC every minute\n        yield* gcLoop().pipe(\n          Effect.repeat(Schedule.spaced(\"1 minute\")),\n          Effect.fork\n        );\n      });\n\n      // Start GC fiber\n      yield* startGCFiber();\n\n      /**\n       * Start background snapshot fiber for idle documents.\n       * This ensures documents with unsnapshot transactions get persisted\n       * even without new transaction activity.\n       */\n      const startSnapshotFiber = Effect.fn(\"engine.snapshot.fiber.start\")(function* () {\n        const idleTimeoutMs = Duration.toMillis(resolvedConfig.snapshot.idleTimeout);\n\n        // Skip if idle snapshots are disabled\n        if (idleTimeoutMs <= 0) {\n          return;\n        }\n\n        const snapshotLoop = Effect.fn(\"engine.snapshot.loop\")(function* () {\n          const current = yield* Ref.get(store);\n          const now = Date.now();\n\n          for (const [documentId, entry] of current) {\n            // Check if document has been idle long enough\n            const lastActivity = yield* Ref.get(entry.lastActivityTime);\n            const idleDuration = now - lastActivity;\n\n            if (idleDuration < idleTimeoutMs) {\n              // Document not idle long enough, skip\n              continue;\n            }\n\n            // Check if document has unsnapshot transactions\n            const needs = yield* entry.instance.needsSnapshot();\n            if (!needs) {\n              continue;\n            }\n\n            // Save snapshot (with error handling)\n            yield* Effect.catchAll(entry.instance.saveSnapshot(), (e) =>\n              Effect.logWarning(\"Periodic snapshot save failed\", {\n                documentId,\n                error: e,\n              })\n            );\n\n            // Track metric\n            yield* Metric.increment(Metrics.storageIdleSnapshots);\n          }\n        });\n\n        // Run snapshot check every 10 seconds\n        yield* snapshotLoop().pipe(\n          Effect.repeat(Schedule.spaced(\"10 seconds\")),\n          Effect.fork\n        );\n      });\n\n      // Start snapshot fiber\n      yield* startSnapshotFiber();\n\n      // Cleanup on shutdown\n      yield* Effect.addFinalizer(() =>\n        Effect.fn(\"engine.shutdown\")(function* () {\n          const current = yield* Ref.get(store);\n          for (const [documentId, entry] of current) {\n            // Best effort save - don't fail shutdown if storage is unavailable\n            yield* Effect.catchAll(entry.instance.saveSnapshot(), (e) =>\n              Effect.logError(\"Failed to save snapshot during shutdown\", {\n                documentId,\n                error: e,\n              })\n            );\n          }\n          yield* Effect.logInfo(\"MimicServerEngine shutdown complete\");\n        })()\n      );\n\n      const engine: MimicServerEngine = {\n        submit: (documentId, transaction) =>\n          Effect.gen(function* () {\n            const instance = yield* getOrCreateDocument(documentId);\n            return yield* instance.submit(transaction);\n          }),\n\n        getSnapshot: (documentId) =>\n          Effect.gen(function* () {\n            const instance = yield* getOrCreateDocument(documentId);\n            return instance.getSnapshot();\n          }),\n\n        subscribe: (documentId) =>\n          Effect.gen(function* () {\n            const instance = yield* getOrCreateDocument(documentId);\n            return Stream.fromPubSub(instance.pubsub) as Stream.Stream<\n              Protocol.ServerMessage,\n              never,\n              never\n            >;\n          }),\n\n        touch: (documentId) =>\n          Effect.gen(function* () {\n            const current = yield* Ref.get(store);\n            const existing = HashMap.get(current, documentId);\n            if (existing._tag === \"Some\") {\n              yield* Ref.set(existing.value.lastActivityTime, Date.now());\n            }\n          }),\n\n        getPresenceSnapshot: (documentId) =>\n          presenceManager.getSnapshot(documentId),\n\n        setPresence: (documentId, connectionId, entry) =>\n          presenceManager.set(documentId, connectionId, entry),\n\n        removePresence: (documentId, connectionId) =>\n          presenceManager.remove(documentId, connectionId),\n\n        subscribePresence: (documentId) =>\n          presenceManager.subscribe(documentId),\n\n        config: resolvedConfig as ResolvedConfig<Primitive.AnyPrimitive>,\n      };\n\n      return engine;\n    })\n  ).pipe(Layer.provide(presenceManagerLayer));\n};\n\n// =============================================================================\n// Re-export namespace\n// =============================================================================\n\nexport const MimicServerEngine = {\n  Tag: MimicServerEngineTag,\n  make,\n};\n\n// =============================================================================\n// Re-export SubmitResult type\n// =============================================================================\n\nexport type { SubmitResult };\n"],"mappings":"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"}
+{"version":3,"file":"MimicServerEngine.mjs","names":["Metrics.documentsEvicted","Metrics.documentsActive","Metrics.storageIdleSnapshots","presenceManagerLayer"],"sources":["../src/MimicServerEngine.ts"],"sourcesContent":["/**\n * @voidhash/mimic-effect - MimicServerEngine\n *\n * Core document management service for Mimic real-time collaboration.\n * Handles document lifecycle, storage, presence, and transaction processing.\n *\n * This is the engine layer - for WebSocket routes, use MimicServer.layerHttpLayerRouter().\n */\nimport {\n  Context,\n  Duration,\n  Effect,\n  HashMap,\n  Layer,\n  Metric,\n  Ref,\n  Schedule,\n  Scope,\n  Stream,\n} from \"effect\";\nimport type { Primitive, Transaction } from \"@voidhash/mimic\";\nimport type {\n  MimicServerEngineConfig,\n  PresenceEntry,\n  PresenceEvent,\n  PresenceSnapshot,\n  ResolvedConfig,\n} from \"./Types\";\nimport type * as Protocol from \"./Protocol\";\nimport { ColdStorageTag } from \"./ColdStorage\";\nimport { HotStorageTag } from \"./HotStorage\";\nimport { MimicAuthServiceTag } from \"./MimicAuthService\";\nimport {\n  DocumentInstance,\n  type SubmitResult,\n  type DocumentInstance as DocumentInstanceType,\n} from \"./DocumentInstance\";\nimport {\n  PresenceManagerTag,\n  layer as presenceManagerLayer,\n} from \"./PresenceManager\";\nimport * as Metrics from \"./Metrics\";\nimport type { ColdStorageError, HotStorageError } from \"./Errors\";\n\n// =============================================================================\n// Types\n// =============================================================================\n\n/**\n * Error type for MimicServerEngine operations\n */\nexport type MimicServerEngineError = ColdStorageError | HotStorageError;\n\n// =============================================================================\n// MimicServerEngine Interface\n// =============================================================================\n\n/**\n * MimicServerEngine service interface.\n *\n * Provides document management operations for Mimic collaboration.\n * Use MimicServer.layerHttpLayerRouter() to create WebSocket routes.\n */\nexport interface MimicServerEngine {\n  /**\n   * Submit a transaction to a document.\n   * Authorization is checked against the auth service.\n   * May fail with MimicServerEngineError if storage is unavailable.\n   */\n  readonly submit: (\n    documentId: string,\n    transaction: Transaction.Transaction\n  ) => Effect.Effect<SubmitResult, MimicServerEngineError>;\n\n  /**\n   * Get document snapshot (current state and version).\n   * Returns flat state format used for storage and synchronization.\n   * May fail with MimicServerEngineError if storage is unavailable.\n   */\n  readonly getSnapshot: (\n    documentId: string\n  ) => Effect.Effect<{ state: unknown; version: number }, MimicServerEngineError>;\n\n  /**\n   * Get tree-like snapshot for rendering.\n   * Returns a readonly structure where trees are converted from\n   * flat state to nested/hierarchical structure suitable for UI rendering.\n   * May fail with MimicServerEngineError if storage is unavailable.\n   */\n  readonly getTreeSnapshot: (\n    documentId: string\n  ) => Effect.Effect<unknown, MimicServerEngineError>;\n\n  /**\n   * Subscribe to document broadcasts (transactions).\n   * Returns a stream of server messages.\n   * Requires a Scope for cleanup when the subscription ends.\n   * May fail with MimicServerEngineError if storage is unavailable.\n   */\n  readonly subscribe: (\n    documentId: string\n  ) => Effect.Effect<Stream.Stream<Protocol.ServerMessage, never, never>, MimicServerEngineError, Scope.Scope>;\n\n  /**\n   * Touch document to prevent idle garbage collection.\n   */\n  readonly touch: (documentId: string) => Effect.Effect<void, never>;\n\n  /**\n   * Get presence snapshot for a document.\n   */\n  readonly getPresenceSnapshot: (\n    documentId: string\n  ) => Effect.Effect<PresenceSnapshot, never>;\n\n  /**\n   * Set presence for a connection.\n   */\n  readonly setPresence: (\n    documentId: string,\n    connectionId: string,\n    entry: PresenceEntry\n  ) => Effect.Effect<void, never>;\n\n  /**\n   * Remove presence for a connection.\n   */\n  readonly removePresence: (\n    documentId: string,\n    connectionId: string\n  ) => Effect.Effect<void, never>;\n\n  /**\n   * Subscribe to presence events for a document.\n   * Requires a Scope for cleanup when the subscription ends.\n   */\n  readonly subscribePresence: (\n    documentId: string\n  ) => Effect.Effect<Stream.Stream<PresenceEvent, never, never>, never, Scope.Scope>;\n\n  /**\n   * Resolved engine configuration.\n   * Used by route layer to access schema, presence config, etc.\n   */\n  readonly config: ResolvedConfig<Primitive.AnyPrimitive>;\n}\n\n// =============================================================================\n// Context Tag\n// =============================================================================\n\n/**\n * Context tag for MimicServerEngine\n */\nexport class MimicServerEngineTag extends Context.Tag(\n  \"@voidhash/mimic-effect/MimicServerEngine\"\n)<MimicServerEngineTag, MimicServerEngine>() {}\n\n// =============================================================================\n// Default Configuration\n// =============================================================================\n\nconst DEFAULT_MAX_IDLE_TIME = Duration.minutes(5);\nconst DEFAULT_MAX_TRANSACTION_HISTORY = 1000;\nconst DEFAULT_SNAPSHOT_INTERVAL = Duration.minutes(5);\nconst DEFAULT_SNAPSHOT_THRESHOLD = 100;\nconst DEFAULT_SNAPSHOT_IDLE_TIMEOUT = Duration.seconds(30);\n\n/**\n * Resolve configuration with defaults\n */\nconst resolveConfig = <TSchema extends Primitive.AnyPrimitive>(\n  config: MimicServerEngineConfig<TSchema>\n): ResolvedConfig<TSchema> => ({\n  schema: config.schema,\n  initial: config.initial,\n  presence: config.presence,\n  maxIdleTime: config.maxIdleTime\n    ? Duration.decode(config.maxIdleTime)\n    : DEFAULT_MAX_IDLE_TIME,\n  maxTransactionHistory:\n    config.maxTransactionHistory ?? DEFAULT_MAX_TRANSACTION_HISTORY,\n  snapshot: {\n    interval: config.snapshot?.interval\n      ? Duration.decode(config.snapshot.interval)\n      : DEFAULT_SNAPSHOT_INTERVAL,\n    transactionThreshold:\n      config.snapshot?.transactionThreshold ?? DEFAULT_SNAPSHOT_THRESHOLD,\n    idleTimeout: config.snapshot?.idleTimeout\n      ? Duration.decode(config.snapshot.idleTimeout)\n      : DEFAULT_SNAPSHOT_IDLE_TIMEOUT,\n  },\n});\n\n// =============================================================================\n// Internal Types\n// =============================================================================\n\n/**\n * Store entry for a document instance with last activity time\n */\ninterface StoreEntry<TSchema extends Primitive.AnyPrimitive> {\n  readonly instance: DocumentInstanceType<TSchema>;\n  readonly lastActivityTime: Ref.Ref<number>;\n}\n\n// =============================================================================\n// Factory\n// =============================================================================\n\n/**\n * Create a MimicServerEngine layer.\n *\n * This creates the core document management service. To expose it via WebSocket,\n * use MimicServer.layerHttpLayerRouter().\n *\n * @example\n * ```typescript\n * // 1. Create the engine\n * const Engine = MimicServerEngine.make({\n *   schema: DocSchema,\n *   initial: { title: \"Untitled\" },\n *   presence: CursorPresence,\n *   maxIdleTime: \"5 minutes\",\n *   snapshot: { interval: \"5 minutes\", transactionThreshold: 100 },\n * })\n *\n * // 2. Create the WebSocket route\n * const MimicRoute = MimicServer.layerHttpLayerRouter({\n *   path: \"/mimic\",\n * })\n *\n * // 3. Wire together\n * const MimicLive = MimicRoute.pipe(\n *   Layer.provide(Engine),\n *   Layer.provide(ColdStorage.InMemory.make()),\n *   Layer.provide(HotStorage.InMemory.make()),\n *   Layer.provide(MimicAuthService.NoAuth.make()),\n * )\n * ```\n */\nexport const make = <TSchema extends Primitive.AnyPrimitive>(\n  config: MimicServerEngineConfig<TSchema>\n): Layer.Layer<\n  MimicServerEngineTag,\n  never,\n  ColdStorageTag | HotStorageTag | MimicAuthServiceTag\n> => {\n  const resolvedConfig = resolveConfig(config);\n\n  return Layer.scoped(\n    MimicServerEngineTag,\n    Effect.gen(function* () {\n      const coldStorage = yield* ColdStorageTag;\n      const hotStorage = yield* HotStorageTag;\n      const presenceManager = yield* PresenceManagerTag;\n\n      // Store: documentId -> StoreEntry\n      const store = yield* Ref.make(\n        HashMap.empty<string, StoreEntry<TSchema>>()\n      );\n\n      /**\n       * Get or create a document instance\n       */\n      const getOrCreateDocument = Effect.fn(\"engine.document.get-or-create\")(\n        function* (documentId: string) {\n          const current = yield* Ref.get(store);\n          const existing = HashMap.get(current, documentId);\n\n          if (existing._tag === \"Some\") {\n            // Update activity time\n            yield* Ref.set(existing.value.lastActivityTime, Date.now());\n            return existing.value.instance;\n          }\n\n          // Create new document instance\n          const instance = yield* DocumentInstance.make(\n            documentId,\n            {\n              schema: config.schema,\n              initial: config.initial,\n              maxTransactionHistory: resolvedConfig.maxTransactionHistory,\n              snapshot: resolvedConfig.snapshot,\n            },\n            coldStorage,\n            hotStorage\n          );\n\n          const lastActivityTime = yield* Ref.make(Date.now());\n\n          // Store it\n          yield* Ref.update(store, (map) =>\n            HashMap.set(map, documentId, { instance, lastActivityTime })\n          );\n\n          return instance;\n        }\n      );\n\n      /**\n       * Start background GC fiber\n       */\n      const startGCFiber = Effect.fn(\"engine.gc.start\")(function* () {\n        const gcLoop = Effect.fn(\"engine.gc.loop\")(function* () {\n          const current = yield* Ref.get(store);\n          const now = Date.now();\n          const maxIdleMs = Duration.toMillis(resolvedConfig.maxIdleTime);\n\n          for (const [documentId, entry] of current) {\n            const lastActivity = yield* Ref.get(entry.lastActivityTime);\n            if (now - lastActivity >= maxIdleMs) {\n              // Save final snapshot before eviction (best effort)\n              yield* Effect.catchAll(entry.instance.saveSnapshot(), (e) =>\n                Effect.logError(\"Failed to save snapshot during eviction\", {\n                  documentId,\n                  error: e,\n                })\n              );\n\n              // Remove from store\n              yield* Ref.update(store, (map) => HashMap.remove(map, documentId));\n\n              // Track eviction metrics\n              yield* Metric.increment(Metrics.documentsEvicted);\n              yield* Metric.incrementBy(Metrics.documentsActive, -1);\n\n              yield* Effect.logInfo(\"Document evicted due to idle timeout\", {\n                documentId,\n              });\n            }\n          }\n        });\n\n        // Run GC every minute\n        yield* gcLoop().pipe(\n          Effect.repeat(Schedule.spaced(\"1 minute\")),\n          Effect.fork\n        );\n      });\n\n      // Start GC fiber\n      yield* startGCFiber();\n\n      /**\n       * Start background snapshot fiber for idle documents.\n       * This ensures documents with unsnapshot transactions get persisted\n       * even without new transaction activity.\n       */\n      const startSnapshotFiber = Effect.fn(\"engine.snapshot.fiber.start\")(function* () {\n        const idleTimeoutMs = Duration.toMillis(resolvedConfig.snapshot.idleTimeout);\n\n        // Skip if idle snapshots are disabled\n        if (idleTimeoutMs <= 0) {\n          return;\n        }\n\n        const snapshotLoop = Effect.fn(\"engine.snapshot.loop\")(function* () {\n          const current = yield* Ref.get(store);\n          const now = Date.now();\n\n          for (const [documentId, entry] of current) {\n            // Check if document has been idle long enough\n            const lastActivity = yield* Ref.get(entry.lastActivityTime);\n            const idleDuration = now - lastActivity;\n\n            if (idleDuration < idleTimeoutMs) {\n              // Document not idle long enough, skip\n              continue;\n            }\n\n            // Check if document has unsnapshot transactions\n            const needs = yield* entry.instance.needsSnapshot();\n            if (!needs) {\n              continue;\n            }\n\n            // Save snapshot (with error handling)\n            yield* Effect.catchAll(entry.instance.saveSnapshot(), (e) =>\n              Effect.logWarning(\"Periodic snapshot save failed\", {\n                documentId,\n                error: e,\n              })\n            );\n\n            // Track metric\n            yield* Metric.increment(Metrics.storageIdleSnapshots);\n          }\n        });\n\n        // Run snapshot check every 10 seconds\n        yield* snapshotLoop().pipe(\n          Effect.repeat(Schedule.spaced(\"10 seconds\")),\n          Effect.fork\n        );\n      });\n\n      // Start snapshot fiber\n      yield* startSnapshotFiber();\n\n      // Cleanup on shutdown\n      yield* Effect.addFinalizer(() =>\n        Effect.fn(\"engine.shutdown\")(function* () {\n          const current = yield* Ref.get(store);\n          for (const [documentId, entry] of current) {\n            // Best effort save - don't fail shutdown if storage is unavailable\n            yield* Effect.catchAll(entry.instance.saveSnapshot(), (e) =>\n              Effect.logError(\"Failed to save snapshot during shutdown\", {\n                documentId,\n                error: e,\n              })\n            );\n          }\n          yield* Effect.logInfo(\"MimicServerEngine shutdown complete\");\n        })()\n      );\n\n      const engine: MimicServerEngine = {\n        submit: (documentId, transaction) =>\n          Effect.gen(function* () {\n            const instance = yield* getOrCreateDocument(documentId);\n            return yield* instance.submit(transaction);\n          }),\n\n        getSnapshot: (documentId) =>\n          Effect.gen(function* () {\n            const instance = yield* getOrCreateDocument(documentId);\n            return instance.getSnapshot();\n          }),\n\n        getTreeSnapshot: (documentId) =>\n          Effect.gen(function* () {\n            const instance = yield* getOrCreateDocument(documentId);\n            return instance.toSnapshot();\n          }),\n\n        subscribe: (documentId) =>\n          Effect.gen(function* () {\n            const instance = yield* getOrCreateDocument(documentId);\n            return Stream.fromPubSub(instance.pubsub) as Stream.Stream<\n              Protocol.ServerMessage,\n              never,\n              never\n            >;\n          }),\n\n        touch: (documentId) =>\n          Effect.gen(function* () {\n            const current = yield* Ref.get(store);\n            const existing = HashMap.get(current, documentId);\n            if (existing._tag === \"Some\") {\n              yield* Ref.set(existing.value.lastActivityTime, Date.now());\n            }\n          }),\n\n        getPresenceSnapshot: (documentId) =>\n          presenceManager.getSnapshot(documentId),\n\n        setPresence: (documentId, connectionId, entry) =>\n          presenceManager.set(documentId, connectionId, entry),\n\n        removePresence: (documentId, connectionId) =>\n          presenceManager.remove(documentId, connectionId),\n\n        subscribePresence: (documentId) =>\n          presenceManager.subscribe(documentId),\n\n        config: resolvedConfig as ResolvedConfig<Primitive.AnyPrimitive>,\n      };\n\n      return engine;\n    })\n  ).pipe(Layer.provide(presenceManagerLayer));\n};\n\n// =============================================================================\n// Re-export namespace\n// =============================================================================\n\nexport const MimicServerEngine = {\n  Tag: MimicServerEngineTag,\n  make,\n};\n\n// =============================================================================\n// Re-export SubmitResult type\n// =============================================================================\n\nexport type { SubmitResult };\n"],"mappings":"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"}

package/dist/testing/HotStorageTestSuite.cjs

@@ -552,6 +552,44 @@ const tests = [
 			yield* require_assertions.assertEqual(entries[1].version, 4, "Second should be version 4");
 		})
 	},
+	{
+		name: "appendWithCheck with baseVersion after full truncate works",
+		category: Categories.GapChecking,
+		run: effect.Effect.gen(function* () {
+			const storage = yield* require_HotStorage.HotStorageTag;
+			yield* storage.appendWithCheck("gap-base-version", makeEntry(1), 1, 0);
+			yield* storage.appendWithCheck("gap-base-version", makeEntry(2), 2, 0);
+			yield* storage.appendWithCheck("gap-base-version", makeEntry(3), 3, 0);
+			yield* storage.truncate("gap-base-version", 3);
+			yield* require_assertions.assertEmpty(yield* storage.getEntries("gap-base-version", 0), "WAL should be empty after full truncate");
+			yield* storage.appendWithCheck("gap-base-version", makeEntry(4), 4, 3);
+			const entries = yield* storage.getEntries("gap-base-version", 0);
+			yield* require_assertions.assertLength(entries, 1, "Should have version 4");
+			yield* require_assertions.assertEqual(entries[0].version, 4, "Entry should be version 4");
+		})
+	},
+	{
+		name: "appendWithCheck with baseVersion still detects gaps",
+		category: Categories.GapChecking,
+		run: effect.Effect.gen(function* () {
+			const storage = yield* require_HotStorage.HotStorageTag;
+			yield* storage.truncate("gap-base-detect", 5);
+			const result = yield* effect.Effect.either(storage.appendWithCheck("gap-base-detect", makeEntry(7), 7, 5));
+			yield* require_assertions.assertTrue(result._tag === "Left", "Should fail when skipping version 6");
+			if (result._tag === "Left") yield* require_assertions.assertTrue(result.left._tag === "WalVersionGapError", "Error should be WalVersionGapError");
+		})
+	},
+	{
+		name: "appendWithCheck with baseVersion=0 allows version 1",
+		category: Categories.GapChecking,
+		run: effect.Effect.gen(function* () {
+			const storage = yield* require_HotStorage.HotStorageTag;
+			yield* storage.appendWithCheck("gap-base-zero", makeEntry(1), 1, 0);
+			const entries = yield* storage.getEntries("gap-base-zero", 0);
+			yield* require_assertions.assertLength(entries, 1, "Should have version 1");
+			yield* require_assertions.assertEqual(entries[0].version, 1, "Entry should be version 1");
+		})
+	},
 	{
 		name: "OperationPath has _tag after roundtrip",
 		category: Categories.TransactionEncoding,

package/dist/testing/HotStorageTestSuite.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"HotStorageTestSuite.d.cts","names":[],"sources":["../../src/testing/HotStorageTestSuite.ts"],"sourcesContent":[],"mappings":";;;;;;;AA4kCA;;;AAxC6B,KA3gCjB,mBAAA,GAAsB,SA2gCL,GA3gCiB,eA2gCjB,GA3gCmC,kBA2gCnC;AAWf,cAv/BD,UAu/BC,EAAA;EAAqB,SAAA,eAAA,EAAA,kBAAA;EAAjC,SAAA,gBAAA,EAAA,mBAAA;EAEA,SAAA,kBAAA,EAAA,qBAAA;EAHwB,SAAO,mBAAA,EAAA,uBAAA;EAAM,SAAA,iBAAA,EAAA,qBAAA;;;;;;;cA8B1B;;;;;;;;;;;;;mBAxCgB,gBAC3B,qBACA;gBAQwB,MAAA,CAAO,OAC/B,YAAY,qBAAqB,uBAEjC"}
+{"version":3,"file":"HotStorageTestSuite.d.cts","names":[],"sources":["../../src/testing/HotStorageTestSuite.ts"],"sourcesContent":[],"mappings":";;;;;;;AAooCA;;;AAxC6B,KAnkCjB,mBAAA,GAAsB,SAmkCL,GAnkCiB,eAmkCjB,GAnkCmC,kBAmkCnC;AAWf,cA/iCD,UA+iCC,EAAA;EAAqB,SAAA,eAAA,EAAA,kBAAA;EAAjC,SAAA,gBAAA,EAAA,mBAAA;EAEA,SAAA,kBAAA,EAAA,qBAAA;EAHwB,SAAO,mBAAA,EAAA,uBAAA;EAAM,SAAA,iBAAA,EAAA,qBAAA;;;;;;;cA8B1B;;;;;;;;;;;;;mBAxCgB,gBAC3B,qBACA;gBAQwB,MAAA,CAAO,OAC/B,YAAY,qBAAqB,uBAEjC"}

package/dist/testing/HotStorageTestSuite.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"HotStorageTestSuite.d.mts","names":[],"sources":["../../src/testing/HotStorageTestSuite.ts"],"sourcesContent":[],"mappings":";;;;;;;AA4kCA;;;AAxC6B,KA3gCjB,mBAAA,GAAsB,SA2gCL,GA3gCiB,eA2gCjB,GA3gCmC,kBA2gCnC;AAWf,cAv/BD,UAu/BC,EAAA;EAAqB,SAAA,eAAA,EAAA,kBAAA;EAAjC,SAAA,gBAAA,EAAA,mBAAA;EAEA,SAAA,kBAAA,EAAA,qBAAA;EAHwB,SAAO,mBAAA,EAAA,uBAAA;EAAM,SAAA,iBAAA,EAAA,qBAAA;;;;;;;cA8B1B;;;;;;;;;;;;;mBAxCgB,gBAC3B,qBACA;gBAQwB,MAAA,CAAO,OAC/B,YAAY,qBAAqB,uBAEjC"}
+{"version":3,"file":"HotStorageTestSuite.d.mts","names":[],"sources":["../../src/testing/HotStorageTestSuite.ts"],"sourcesContent":[],"mappings":";;;;;;;AAooCA;;;AAxC6B,KAnkCjB,mBAAA,GAAsB,SAmkCL,GAnkCiB,eAmkCjB,GAnkCmC,kBAmkCnC;AAWf,cA/iCD,UA+iCC,EAAA;EAAqB,SAAA,eAAA,EAAA,kBAAA;EAAjC,SAAA,gBAAA,EAAA,mBAAA;EAEA,SAAA,kBAAA,EAAA,qBAAA;EAHwB,SAAO,mBAAA,EAAA,uBAAA;EAAM,SAAA,iBAAA,EAAA,qBAAA;;;;;;;cA8B1B;;;;;;;;;;;;;mBAxCgB,gBAC3B,qBACA;gBAQwB,MAAA,CAAO,OAC/B,YAAY,qBAAqB,uBAEjC"}

package/dist/testing/HotStorageTestSuite.mjs

@@ -552,6 +552,44 @@ const tests = [
 			yield* assertEqual(entries[1].version, 4, "Second should be version 4");
 		})
 	},
+	{
+		name: "appendWithCheck with baseVersion after full truncate works",
+		category: Categories.GapChecking,
+		run: Effect.gen(function* () {
+			const storage = yield* HotStorageTag;
+			yield* storage.appendWithCheck("gap-base-version", makeEntry(1), 1, 0);
+			yield* storage.appendWithCheck("gap-base-version", makeEntry(2), 2, 0);
+			yield* storage.appendWithCheck("gap-base-version", makeEntry(3), 3, 0);
+			yield* storage.truncate("gap-base-version", 3);
+			yield* assertEmpty(yield* storage.getEntries("gap-base-version", 0), "WAL should be empty after full truncate");
+			yield* storage.appendWithCheck("gap-base-version", makeEntry(4), 4, 3);
+			const entries = yield* storage.getEntries("gap-base-version", 0);
+			yield* assertLength(entries, 1, "Should have version 4");
+			yield* assertEqual(entries[0].version, 4, "Entry should be version 4");
+		})
+	},
+	{
+		name: "appendWithCheck with baseVersion still detects gaps",
+		category: Categories.GapChecking,
+		run: Effect.gen(function* () {
+			const storage = yield* HotStorageTag;
+			yield* storage.truncate("gap-base-detect", 5);
+			const result = yield* Effect.either(storage.appendWithCheck("gap-base-detect", makeEntry(7), 7, 5));
+			yield* assertTrue(result._tag === "Left", "Should fail when skipping version 6");
+			if (result._tag === "Left") yield* assertTrue(result.left._tag === "WalVersionGapError", "Error should be WalVersionGapError");
+		})
+	},
+	{
+		name: "appendWithCheck with baseVersion=0 allows version 1",
+		category: Categories.GapChecking,
+		run: Effect.gen(function* () {
+			const storage = yield* HotStorageTag;
+			yield* storage.appendWithCheck("gap-base-zero", makeEntry(1), 1, 0);
+			const entries = yield* storage.getEntries("gap-base-zero", 0);
+			yield* assertLength(entries, 1, "Should have version 1");
+			yield* assertEqual(entries[0].version, 1, "Entry should be version 1");
+		})
+	},
 	{
 		name: "OperationPath has _tag after roundtrip",
 		category: Categories.TransactionEncoding,