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

package/dist/MimicServerEngine.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"MimicServerEngine.mjs","names":["documentManagerLayer","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  Layer,\n  Scope,\n  Stream,\n} from \"effect\";\nimport type { Presence, 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  DocumentManagerTag,\n  DocumentManagerConfigTag,\n  layer as documentManagerLayer,\n  type SubmitResult,\n} from \"./DocumentManager\";\nimport {\n  PresenceManagerTag,\n  layer as presenceManagerLayer,\n} from \"./PresenceManager\";\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   */\n  readonly submit: (\n    documentId: string,\n    transaction: Transaction.Transaction\n  ) => Effect.Effect<SubmitResult, never>;\n\n  /**\n   * Get document snapshot (current state and version).\n   */\n  readonly getSnapshot: (\n    documentId: string\n  ) => Effect.Effect<{ state: unknown; version: number }, never>;\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   */\n  readonly subscribe: (\n    documentId: string\n  ) => Effect.Effect<Stream.Stream<Protocol.ServerMessage, never, never>, never, 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;\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  },\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  // Create config layer for DocumentManager\n  const configLayer = Layer.succeed(\n    DocumentManagerConfigTag,\n    resolvedConfig as ResolvedConfig<Primitive.AnyPrimitive>\n  );\n\n  // Create internal layers\n  const internalLayers = Layer.mergeAll(\n    documentManagerLayer.pipe(Layer.provide(configLayer)),\n    presenceManagerLayer\n  );\n\n  return Layer.scoped(\n    MimicServerEngineTag,\n    Effect.gen(function* () {\n      const documentManager = yield* DocumentManagerTag;\n      const presenceManager = yield* PresenceManagerTag;\n\n      const engine: MimicServerEngine = {\n        submit: (documentId, transaction) =>\n          documentManager.submit(documentId, transaction),\n\n        getSnapshot: (documentId) => documentManager.getSnapshot(documentId),\n\n        subscribe: (documentId) =>\n          documentManager.subscribe(documentId) as Effect.Effect<\n            Stream.Stream<Protocol.ServerMessage, never, never>,\n            never\n          >,\n\n        touch: (documentId) => documentManager.touch(documentId),\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(internalLayers));\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":";;;;;;;;;;;;;;;;AA8HA,IAAa,uBAAb,cAA0C,QAAQ,IAChD,2CACD,EAA2C,CAAC;AAM7C,MAAM,wBAAwB,SAAS,QAAQ,EAAE;AACjD,MAAM,kCAAkC;AACxC,MAAM,4BAA4B,SAAS,QAAQ,EAAE;AACrD,MAAM,6BAA6B;;;;AAKnC,MAAM,iBACJ,WAC4B;;QAAC;EAC7B,QAAQ,OAAO;EACf,SAAS,OAAO;EAChB,UAAU,OAAO;EACjB,aAAa,OAAO,cAChB,SAAS,OAAO,OAAO,YAAY,GACnC;EACJ,gDACE,OAAO,8FAAyB;EAClC,UAAU;GACR,+BAAU,OAAO,8EAAU,YACvB,SAAS,OAAO,OAAO,SAAS,SAAS,GACzC;GACJ,oEACE,OAAO,gFAAU,6FAAwB;GAC5C;EACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCD,MAAa,QACX,WAKG;CACH,MAAM,iBAAiB,cAAc,OAAO;CAG5C,MAAM,cAAc,MAAM,QACxB,0BACA,eACD;CAGD,MAAM,iBAAiB,MAAM,SAC3BA,MAAqB,KAAK,MAAM,QAAQ,YAAY,CAAC,EACrDC,QACD;AAED,QAAO,MAAM,OACX,sBACA,OAAO,IAAI,aAAa;EACtB,MAAM,kBAAkB,OAAO;EAC/B,MAAM,kBAAkB,OAAO;AA+B/B,SA7BkC;GAChC,SAAS,YAAY,gBACnB,gBAAgB,OAAO,YAAY,YAAY;GAEjD,cAAc,eAAe,gBAAgB,YAAY,WAAW;GAEpE,YAAY,eACV,gBAAgB,UAAU,WAAW;GAKvC,QAAQ,eAAe,gBAAgB,MAAM,WAAW;GAExD,sBAAsB,eACpB,gBAAgB,YAAY,WAAW;GAEzC,cAAc,YAAY,cAAc,UACtC,gBAAgB,IAAI,YAAY,cAAc,MAAM;GAEtD,iBAAiB,YAAY,iBAC3B,gBAAgB,OAAO,YAAY,aAAa;GAElD,oBAAoB,eAClB,gBAAgB,UAAU,WAAW;GAEvC,QAAQ;GACT;GAGD,CACH,CAAC,KAAK,MAAM,QAAQ,eAAe,CAAC;;AAOvC,MAAa,oBAAoB;CAC/B,KAAK;CACL;CACD"}
+{"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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"}

package/dist/PresenceManager.cjs

@@ -20,7 +20,7 @@ const layer = effect.Layer.effect(PresenceManagerTag, effect.Effect.gen(function
 	/**
 	* Get or create presence state for a document
 	*/
-	const getOrCreateDocumentState = (documentId) => effect.Effect.gen(function* () {
+	const getOrCreateDocumentState = effect.Effect.fn("presence.document-state.get-or-create")(function* (documentId) {
 		const current = yield* effect.Ref.get(store);
 		const existing = effect.HashMap.get(current, documentId);
 		if (existing._tag === "Some") return existing.value;
@@ -33,7 +33,7 @@ const layer = effect.Layer.effect(PresenceManagerTag, effect.Effect.gen(function
 		return state;
 	});
 	return {
-		getSnapshot: (documentId) => effect.Effect.gen(function* () {
+		getSnapshot: effect.Effect.fn("presence.snapshot.get")(function* (documentId) {
 			const current = yield* effect.Ref.get(store);
 			const existing = effect.HashMap.get(current, documentId);
 			if (existing._tag === "None") return { presences: {} };
@@ -41,7 +41,7 @@ const layer = effect.Layer.effect(PresenceManagerTag, effect.Effect.gen(function
 			for (const [id, entry] of existing.value.presences) presences[id] = entry;
 			return { presences };
 		}),
-		set: (documentId, connectionId, entry) => effect.Effect.gen(function* () {
+		set: effect.Effect.fn("presence.set")(function* (documentId, connectionId, entry) {
 			const state = yield* getOrCreateDocumentState(documentId);
 			yield* effect.Ref.update(store, (map) => {
 				const existing = effect.HashMap.get(map, documentId);
@@ -58,7 +58,7 @@ const layer = effect.Layer.effect(PresenceManagerTag, effect.Effect.gen(function
 			};
 			yield* effect.PubSub.publish(state.pubsub, event);
 		}),
-		remove: (documentId, connectionId) => effect.Effect.gen(function* () {
+		remove: effect.Effect.fn("presence.remove")(function* (documentId, connectionId) {
 			const current = yield* effect.Ref.get(store);
 			const existing = effect.HashMap.get(current, documentId);
 			if (existing._tag === "None") return;
@@ -75,7 +75,7 @@ const layer = effect.Layer.effect(PresenceManagerTag, effect.Effect.gen(function
 			};
 			yield* effect.PubSub.publish(existing.value.pubsub, event);
 		}),
-		subscribe: (documentId) => effect.Effect.gen(function* () {
+		subscribe: effect.Effect.fn("presence.subscribe")(function* (documentId) {
 			const state = yield* getOrCreateDocumentState(documentId);
 			return effect.Stream.fromPubSub(state.pubsub);
 		})

package/dist/PresenceManager.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"PresenceManager.d.cts","names":[],"sources":["../src/PresenceManager.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;AAgEO,UA/BU,eAAA,CA+BH;EAAM;AACnB;;gDA1BM,MAAA,CAAO,OAAO;;;AAmCrB;EAoJa,SAAA,GAAA,EAAA,CAAA,UAGZ,EAAA,MAAA,EAAA,YAAA,EAAA,MAAA,EAAA,KAAA,EAlLU,aAkLV,EAAA,GAjLM,MAAA,CAAO,MAiLb,CAAA,IAAA,CAAA;;;;iEAzKM,MAAA,CAAO;;;;;8CAQP,MAAA,CAAO,OAAO,MAAA,CAAO,OAAO,uBAAuB,KAAA,CAAM;;cAC/D;;;;cASY,kBAAA,SAA2B,uBAAA;cAoJ3B"}
+{"version":3,"file":"PresenceManager.d.cts","names":[],"sources":["../src/PresenceManager.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;AAgEO,UA/BU,eAAA,CA+BH;EAAM;AACnB;;gDA1BM,MAAA,CAAO,OAAO;;;AAmCrB;EA8Ja,SAAA,GAAA,EAAA,CAAA,UAGZ,EAAA,MAAA,EAAA,YAAA,EAAA,MAAA,EAAA,KAAA,EA5LU,aA4LV,EAAA,GA3LM,MAAA,CAAO,MA2Lb,CAAA,IAAA,CAAA;;;;iEAnLM,MAAA,CAAO;;;;;8CAQP,MAAA,CAAO,OAAO,MAAA,CAAO,OAAO,uBAAuB,KAAA,CAAM;;cAC/D;;;;cASY,kBAAA,SAA2B,uBAAA;cA8J3B"}

package/dist/PresenceManager.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"PresenceManager.d.mts","names":[],"sources":["../src/PresenceManager.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;AAgEO,UA/BU,eAAA,CA+BH;EAAM;AACnB;;gDA1BM,MAAA,CAAO,OAAO;;;AAmCrB;EAoJa,SAAA,GAAA,EAAA,CAAA,UAGZ,EAAA,MAAA,EAAA,YAAA,EAAA,MAAA,EAAA,KAAA,EAlLU,aAkLV,EAAA,GAjLM,MAAA,CAAO,MAiLb,CAAA,IAAA,CAAA;;;;iEAzKM,MAAA,CAAO;;;;;8CAQP,MAAA,CAAO,OAAO,MAAA,CAAO,OAAO,uBAAuB,KAAA,CAAM;;cAC/D;;;;cASY,kBAAA,SAA2B,uBAAA;cAoJ3B"}
+{"version":3,"file":"PresenceManager.d.mts","names":[],"sources":["../src/PresenceManager.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;AAgEO,UA/BU,eAAA,CA+BH;EAAM;AACnB;;gDA1BM,MAAA,CAAO,OAAO;;;AAmCrB;EA8Ja,SAAA,GAAA,EAAA,CAAA,UAGZ,EAAA,MAAA,EAAA,YAAA,EAAA,MAAA,EAAA,KAAA,EA5LU,aA4LV,EAAA,GA3LM,MAAA,CAAO,MA2Lb,CAAA,IAAA,CAAA;;;;iEAnLM,MAAA,CAAO;;;;;8CAQP,MAAA,CAAO,OAAO,MAAA,CAAO,OAAO,uBAAuB,KAAA,CAAM;;cAC/D;;;;cASY,kBAAA,SAA2B,uBAAA;cA8J3B"}

package/dist/PresenceManager.mjs

@@ -20,7 +20,7 @@ const layer = Layer.effect(PresenceManagerTag, Effect.gen(function* () {
 	/**
 	* Get or create presence state for a document
 	*/
-	const getOrCreateDocumentState = (documentId) => Effect.gen(function* () {
+	const getOrCreateDocumentState = Effect.fn("presence.document-state.get-or-create")(function* (documentId) {
 		const current = yield* Ref.get(store);
 		const existing = HashMap.get(current, documentId);
 		if (existing._tag === "Some") return existing.value;
@@ -33,7 +33,7 @@ const layer = Layer.effect(PresenceManagerTag, Effect.gen(function* () {
 		return state;
 	});
 	return {
-		getSnapshot: (documentId) => Effect.gen(function* () {
+		getSnapshot: Effect.fn("presence.snapshot.get")(function* (documentId) {
 			const current = yield* Ref.get(store);
 			const existing = HashMap.get(current, documentId);
 			if (existing._tag === "None") return { presences: {} };
@@ -41,7 +41,7 @@ const layer = Layer.effect(PresenceManagerTag, Effect.gen(function* () {
 			for (const [id, entry] of existing.value.presences) presences[id] = entry;
 			return { presences };
 		}),
-		set: (documentId, connectionId, entry) => Effect.gen(function* () {
+		set: Effect.fn("presence.set")(function* (documentId, connectionId, entry) {
 			const state = yield* getOrCreateDocumentState(documentId);
 			yield* Ref.update(store, (map) => {
 				const existing = HashMap.get(map, documentId);
@@ -58,7 +58,7 @@ const layer = Layer.effect(PresenceManagerTag, Effect.gen(function* () {
 			};
 			yield* PubSub.publish(state.pubsub, event);
 		}),
-		remove: (documentId, connectionId) => Effect.gen(function* () {
+		remove: Effect.fn("presence.remove")(function* (documentId, connectionId) {
 			const current = yield* Ref.get(store);
 			const existing = HashMap.get(current, documentId);
 			if (existing._tag === "None") return;
@@ -75,7 +75,7 @@ const layer = Layer.effect(PresenceManagerTag, Effect.gen(function* () {
 			};
 			yield* PubSub.publish(existing.value.pubsub, event);
 		}),
-		subscribe: (documentId) => Effect.gen(function* () {
+		subscribe: Effect.fn("presence.subscribe")(function* (documentId) {
 			const state = yield* getOrCreateDocumentState(documentId);
 			return Stream.fromPubSub(state.pubsub);
 		})

package/dist/PresenceManager.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"PresenceManager.mjs","names":["layer: Layer.Layer<PresenceManagerTag>","state: DocumentPresenceState","presences: Record<string, PresenceEntry>","Metrics.presenceUpdates","Metrics.presenceActive","event: PresenceEvent"],"sources":["../src/PresenceManager.ts"],"sourcesContent":["/**\n * @voidhash/mimic-effect - PresenceManager\n *\n * Internal service for managing presence state per document.\n */\nimport {\n  Context,\n  Effect,\n  HashMap,\n  Layer,\n  Metric,\n  PubSub,\n  Ref,\n  Scope,\n  Stream,\n} from \"effect\";\nimport type {\n  PresenceEntry,\n  PresenceEvent,\n  PresenceSnapshot,\n} from \"./Types\";\nimport * as Metrics from \"./Metrics\";\n\n// =============================================================================\n// PresenceManager Interface\n// =============================================================================\n\n/**\n * Internal service for managing presence state per document.\n *\n * Presence is ephemeral state associated with connections, not persisted.\n * Each document has its own set of presences, keyed by connectionId.\n */\nexport interface PresenceManager {\n  /**\n   * Get snapshot of all presences for a document.\n   */\n  readonly getSnapshot: (\n    documentId: string\n  ) => Effect.Effect<PresenceSnapshot>;\n\n  /**\n   * Set/update presence for a connection.\n   */\n  readonly set: (\n    documentId: string,\n    connectionId: string,\n    entry: PresenceEntry\n  ) => Effect.Effect<void>;\n\n  /**\n   * Remove presence for a connection (on disconnect).\n   */\n  readonly remove: (\n    documentId: string,\n    connectionId: string\n  ) => Effect.Effect<void>;\n\n  /**\n   * Subscribe to presence events for a document.\n   * Returns a stream of presence update/remove events.\n   */\n  readonly subscribe: (\n    documentId: string\n  ) => Effect.Effect<Stream.Stream<PresenceEvent>, never, Scope.Scope>;\n}\n\n// =============================================================================\n// Context Tag\n// =============================================================================\n\n/**\n * Context tag for PresenceManager service\n */\nexport class PresenceManagerTag extends Context.Tag(\n  \"@voidhash/mimic-effect/PresenceManager\"\n)<PresenceManagerTag, PresenceManager>() {}\n\n// =============================================================================\n// Internal Types\n// =============================================================================\n\n/**\n * Per-document presence state\n */\ninterface DocumentPresenceState {\n  readonly presences: HashMap.HashMap<string, PresenceEntry>;\n  readonly pubsub: PubSub.PubSub<PresenceEvent>;\n}\n\n// =============================================================================\n// Layer Implementation\n// =============================================================================\n\n/**\n * Create the PresenceManager layer.\n */\nexport const layer: Layer.Layer<PresenceManagerTag> = Layer.effect(\n  PresenceManagerTag,\n  Effect.gen(function* () {\n    // Store: documentId -> DocumentPresenceState\n    const store = yield* Ref.make(\n      HashMap.empty<string, DocumentPresenceState>()\n    );\n\n    /**\n     * Get or create presence state for a document\n     */\n    const getOrCreateDocumentState = (\n      documentId: string\n    ): Effect.Effect<DocumentPresenceState> =>\n      Effect.gen(function* () {\n        const current = yield* Ref.get(store);\n        const existing = HashMap.get(current, documentId);\n        if (existing._tag === \"Some\") {\n          return existing.value;\n        }\n\n        // Create new state for this document\n        const pubsub = yield* PubSub.unbounded<PresenceEvent>();\n        const state: DocumentPresenceState = {\n          presences: HashMap.empty(),\n          pubsub,\n        };\n\n        yield* Ref.update(store, (map) => HashMap.set(map, documentId, state));\n        return state;\n      });\n\n    return {\n      getSnapshot: (documentId) =>\n        Effect.gen(function* () {\n          const current = yield* Ref.get(store);\n          const existing = HashMap.get(current, documentId);\n          if (existing._tag === \"None\") {\n            return { presences: {} };\n          }\n\n          // Convert HashMap to Record\n          const presences: Record<string, PresenceEntry> = {};\n          for (const [id, entry] of existing.value.presences) {\n            presences[id] = entry;\n          }\n          return { presences };\n        }),\n\n      set: (documentId, connectionId, entry) =>\n        Effect.gen(function* () {\n          const state = yield* getOrCreateDocumentState(documentId);\n\n          // Update presence in store\n          yield* Ref.update(store, (map) => {\n            const existing = HashMap.get(map, documentId);\n            if (existing._tag === \"None\") return map;\n            return HashMap.set(map, documentId, {\n              ...existing.value,\n              presences: HashMap.set(\n                existing.value.presences,\n                connectionId,\n                entry\n              ),\n            });\n          });\n\n          // Track metrics\n          yield* Metric.increment(Metrics.presenceUpdates);\n          yield* Metric.incrementBy(Metrics.presenceActive, 1);\n\n          // Broadcast update event\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.pubsub, event);\n        }),\n\n      remove: (documentId, connectionId) =>\n        Effect.gen(function* () {\n          const current = yield* Ref.get(store);\n          const existing = HashMap.get(current, documentId);\n          if (existing._tag === \"None\") return;\n\n          // Check if presence exists before removing\n          const hasPresence = HashMap.has(existing.value.presences, connectionId);\n          if (!hasPresence) return;\n\n          // Remove presence from store\n          yield* Ref.update(store, (map) => {\n            const docState = HashMap.get(map, documentId);\n            if (docState._tag === \"None\") return map;\n            return HashMap.set(map, documentId, {\n              ...docState.value,\n              presences: HashMap.remove(docState.value.presences, connectionId),\n            });\n          });\n\n          // Track metrics\n          yield* Metric.incrementBy(Metrics.presenceActive, -1);\n\n          // Broadcast remove event\n          const event: PresenceEvent = {\n            type: \"presence_remove\",\n            id: connectionId,\n          };\n          yield* PubSub.publish(existing.value.pubsub, event);\n        }),\n\n      subscribe: (documentId) =>\n        Effect.gen(function* () {\n          const state = yield* getOrCreateDocumentState(documentId);\n          return Stream.fromPubSub(state.pubsub);\n        }),\n    };\n  })\n);\n\n// =============================================================================\n// Re-export namespace\n// =============================================================================\n\nexport const PresenceManager = {\n  Tag: PresenceManagerTag,\n  layer,\n};\n"],"mappings":";;;;;;;;;;;;;AA0EA,IAAa,qBAAb,cAAwC,QAAQ,IAC9C,yCACD,EAAuC,CAAC;;;;AAqBzC,MAAaA,QAAyC,MAAM,OAC1D,oBACA,OAAO,IAAI,aAAa;CAEtB,MAAM,QAAQ,OAAO,IAAI,KACvB,QAAQ,OAAsC,CAC/C;;;;CAKD,MAAM,4BACJ,eAEA,OAAO,IAAI,aAAa;EACtB,MAAM,UAAU,OAAO,IAAI,IAAI,MAAM;EACrC,MAAM,WAAW,QAAQ,IAAI,SAAS,WAAW;AACjD,MAAI,SAAS,SAAS,OACpB,QAAO,SAAS;EAIlB,MAAM,SAAS,OAAO,OAAO,WAA0B;EACvD,MAAMC,QAA+B;GACnC,WAAW,QAAQ,OAAO;GAC1B;GACD;AAED,SAAO,IAAI,OAAO,QAAQ,QAAQ,QAAQ,IAAI,KAAK,YAAY,MAAM,CAAC;AACtE,SAAO;GACP;AAEJ,QAAO;EACL,cAAc,eACZ,OAAO,IAAI,aAAa;GACtB,MAAM,UAAU,OAAO,IAAI,IAAI,MAAM;GACrC,MAAM,WAAW,QAAQ,IAAI,SAAS,WAAW;AACjD,OAAI,SAAS,SAAS,OACpB,QAAO,EAAE,WAAW,EAAE,EAAE;GAI1B,MAAMC,YAA2C,EAAE;AACnD,QAAK,MAAM,CAAC,IAAI,UAAU,SAAS,MAAM,UACvC,WAAU,MAAM;AAElB,UAAO,EAAE,WAAW;IACpB;EAEJ,MAAM,YAAY,cAAc,UAC9B,OAAO,IAAI,aAAa;GACtB,MAAM,QAAQ,OAAO,yBAAyB,WAAW;AAGzD,UAAO,IAAI,OAAO,QAAQ,QAAQ;IAChC,MAAM,WAAW,QAAQ,IAAI,KAAK,WAAW;AAC7C,QAAI,SAAS,SAAS,OAAQ,QAAO;AACrC,WAAO,QAAQ,IAAI,KAAK,8CACnB,SAAS,cACZ,WAAW,QAAQ,IACjB,SAAS,MAAM,WACf,cACA,MACD,IACD;KACF;AAGF,UAAO,OAAO,UAAUC,gBAAwB;AAChD,UAAO,OAAO,YAAYC,gBAAwB,EAAE;GAGpD,MAAMC,QAAuB;IAC3B,MAAM;IACN,IAAI;IACJ,MAAM,MAAM;IACZ,QAAQ,MAAM;IACf;AACD,UAAO,OAAO,QAAQ,MAAM,QAAQ,MAAM;IAC1C;EAEJ,SAAS,YAAY,iBACnB,OAAO,IAAI,aAAa;GACtB,MAAM,UAAU,OAAO,IAAI,IAAI,MAAM;GACrC,MAAM,WAAW,QAAQ,IAAI,SAAS,WAAW;AACjD,OAAI,SAAS,SAAS,OAAQ;AAI9B,OAAI,CADgB,QAAQ,IAAI,SAAS,MAAM,WAAW,aAAa,CACrD;AAGlB,UAAO,IAAI,OAAO,QAAQ,QAAQ;IAChC,MAAM,WAAW,QAAQ,IAAI,KAAK,WAAW;AAC7C,QAAI,SAAS,SAAS,OAAQ,QAAO;AACrC,WAAO,QAAQ,IAAI,KAAK,8CACnB,SAAS,cACZ,WAAW,QAAQ,OAAO,SAAS,MAAM,WAAW,aAAa,IACjE;KACF;AAGF,UAAO,OAAO,YAAYD,gBAAwB,GAAG;GAGrD,MAAMC,QAAuB;IAC3B,MAAM;IACN,IAAI;IACL;AACD,UAAO,OAAO,QAAQ,SAAS,MAAM,QAAQ,MAAM;IACnD;EAEJ,YAAY,eACV,OAAO,IAAI,aAAa;GACtB,MAAM,QAAQ,OAAO,yBAAyB,WAAW;AACzD,UAAO,OAAO,WAAW,MAAM,OAAO;IACtC;EACL;EACD,CACH;AAMD,MAAa,kBAAkB;CAC7B,KAAK;CACL;CACD"}
+{"version":3,"file":"PresenceManager.mjs","names":["layer: Layer.Layer<PresenceManagerTag>","state: DocumentPresenceState","presences: Record<string, PresenceEntry>","Metrics.presenceUpdates","Metrics.presenceActive","event: PresenceEvent"],"sources":["../src/PresenceManager.ts"],"sourcesContent":["/**\n * @voidhash/mimic-effect - PresenceManager\n *\n * Internal service for managing presence state per document.\n */\nimport {\n  Context,\n  Effect,\n  HashMap,\n  Layer,\n  Metric,\n  PubSub,\n  Ref,\n  Scope,\n  Stream,\n} from \"effect\";\nimport type {\n  PresenceEntry,\n  PresenceEvent,\n  PresenceSnapshot,\n} from \"./Types\";\nimport * as Metrics from \"./Metrics\";\n\n// =============================================================================\n// PresenceManager Interface\n// =============================================================================\n\n/**\n * Internal service for managing presence state per document.\n *\n * Presence is ephemeral state associated with connections, not persisted.\n * Each document has its own set of presences, keyed by connectionId.\n */\nexport interface PresenceManager {\n  /**\n   * Get snapshot of all presences for a document.\n   */\n  readonly getSnapshot: (\n    documentId: string\n  ) => Effect.Effect<PresenceSnapshot>;\n\n  /**\n   * Set/update presence for a connection.\n   */\n  readonly set: (\n    documentId: string,\n    connectionId: string,\n    entry: PresenceEntry\n  ) => Effect.Effect<void>;\n\n  /**\n   * Remove presence for a connection (on disconnect).\n   */\n  readonly remove: (\n    documentId: string,\n    connectionId: string\n  ) => Effect.Effect<void>;\n\n  /**\n   * Subscribe to presence events for a document.\n   * Returns a stream of presence update/remove events.\n   */\n  readonly subscribe: (\n    documentId: string\n  ) => Effect.Effect<Stream.Stream<PresenceEvent>, never, Scope.Scope>;\n}\n\n// =============================================================================\n// Context Tag\n// =============================================================================\n\n/**\n * Context tag for PresenceManager service\n */\nexport class PresenceManagerTag extends Context.Tag(\n  \"@voidhash/mimic-effect/PresenceManager\"\n)<PresenceManagerTag, PresenceManager>() {}\n\n// =============================================================================\n// Internal Types\n// =============================================================================\n\n/**\n * Per-document presence state\n */\ninterface DocumentPresenceState {\n  readonly presences: HashMap.HashMap<string, PresenceEntry>;\n  readonly pubsub: PubSub.PubSub<PresenceEvent>;\n}\n\n// =============================================================================\n// Layer Implementation\n// =============================================================================\n\n/**\n * Create the PresenceManager layer.\n */\nexport const layer: Layer.Layer<PresenceManagerTag> = Layer.effect(\n  PresenceManagerTag,\n  Effect.gen(function* () {\n    // Store: documentId -> DocumentPresenceState\n    const store = yield* Ref.make(\n      HashMap.empty<string, DocumentPresenceState>()\n    );\n\n    /**\n     * Get or create presence state for a document\n     */\n    const getOrCreateDocumentState = Effect.fn(\n      \"presence.document-state.get-or-create\"\n    )(function* (documentId: string) {\n      const current = yield* Ref.get(store);\n      const existing = HashMap.get(current, documentId);\n      if (existing._tag === \"Some\") {\n        return existing.value;\n      }\n\n      // Create new state for this document\n      const pubsub = yield* PubSub.unbounded<PresenceEvent>();\n      const state: DocumentPresenceState = {\n        presences: HashMap.empty(),\n        pubsub,\n      };\n\n      yield* Ref.update(store, (map) => HashMap.set(map, documentId, state));\n      return state;\n    });\n\n    return {\n      getSnapshot: Effect.fn(\"presence.snapshot.get\")(\n        function* (documentId: string) {\n          const current = yield* Ref.get(store);\n          const existing = HashMap.get(current, documentId);\n          if (existing._tag === \"None\") {\n            return { presences: {} };\n          }\n\n          // Convert HashMap to Record\n          const presences: Record<string, PresenceEntry> = {};\n          for (const [id, entry] of existing.value.presences) {\n            presences[id] = entry;\n          }\n          return { presences };\n        }\n      ),\n\n      set: Effect.fn(\"presence.set\")(\n        function* (\n          documentId: string,\n          connectionId: string,\n          entry: PresenceEntry\n        ) {\n          const state = yield* getOrCreateDocumentState(documentId);\n\n          // Update presence in store\n          yield* Ref.update(store, (map) => {\n            const existing = HashMap.get(map, documentId);\n            if (existing._tag === \"None\") return map;\n            return HashMap.set(map, documentId, {\n              ...existing.value,\n              presences: HashMap.set(\n                existing.value.presences,\n                connectionId,\n                entry\n              ),\n            });\n          });\n\n          // Track metrics\n          yield* Metric.increment(Metrics.presenceUpdates);\n          yield* Metric.incrementBy(Metrics.presenceActive, 1);\n\n          // Broadcast update event\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.pubsub, event);\n        }\n      ),\n\n      remove: Effect.fn(\"presence.remove\")(\n        function* (documentId: string, connectionId: string) {\n          const current = yield* Ref.get(store);\n          const existing = HashMap.get(current, documentId);\n          if (existing._tag === \"None\") return;\n\n          // Check if presence exists before removing\n          const hasPresence = HashMap.has(\n            existing.value.presences,\n            connectionId\n          );\n          if (!hasPresence) return;\n\n          // Remove presence from store\n          yield* Ref.update(store, (map) => {\n            const docState = HashMap.get(map, documentId);\n            if (docState._tag === \"None\") return map;\n            return HashMap.set(map, documentId, {\n              ...docState.value,\n              presences: HashMap.remove(docState.value.presences, connectionId),\n            });\n          });\n\n          // Track metrics\n          yield* Metric.incrementBy(Metrics.presenceActive, -1);\n\n          // Broadcast remove event\n          const event: PresenceEvent = {\n            type: \"presence_remove\",\n            id: connectionId,\n          };\n          yield* PubSub.publish(existing.value.pubsub, event);\n        }\n      ),\n\n      subscribe: Effect.fn(\"presence.subscribe\")(\n        function* (documentId: string) {\n          const state = yield* getOrCreateDocumentState(documentId);\n          return Stream.fromPubSub(state.pubsub);\n        }\n      ),\n    };\n  })\n);\n\n// =============================================================================\n// Re-export namespace\n// =============================================================================\n\nexport const PresenceManager = {\n  Tag: PresenceManagerTag,\n  layer,\n};\n"],"mappings":";;;;;;;;;;;;;AA0EA,IAAa,qBAAb,cAAwC,QAAQ,IAC9C,yCACD,EAAuC,CAAC;;;;AAqBzC,MAAaA,QAAyC,MAAM,OAC1D,oBACA,OAAO,IAAI,aAAa;CAEtB,MAAM,QAAQ,OAAO,IAAI,KACvB,QAAQ,OAAsC,CAC/C;;;;CAKD,MAAM,2BAA2B,OAAO,GACtC,wCACD,CAAC,WAAW,YAAoB;EAC/B,MAAM,UAAU,OAAO,IAAI,IAAI,MAAM;EACrC,MAAM,WAAW,QAAQ,IAAI,SAAS,WAAW;AACjD,MAAI,SAAS,SAAS,OACpB,QAAO,SAAS;EAIlB,MAAM,SAAS,OAAO,OAAO,WAA0B;EACvD,MAAMC,QAA+B;GACnC,WAAW,QAAQ,OAAO;GAC1B;GACD;AAED,SAAO,IAAI,OAAO,QAAQ,QAAQ,QAAQ,IAAI,KAAK,YAAY,MAAM,CAAC;AACtE,SAAO;GACP;AAEF,QAAO;EACL,aAAa,OAAO,GAAG,wBAAwB,CAC7C,WAAW,YAAoB;GAC7B,MAAM,UAAU,OAAO,IAAI,IAAI,MAAM;GACrC,MAAM,WAAW,QAAQ,IAAI,SAAS,WAAW;AACjD,OAAI,SAAS,SAAS,OACpB,QAAO,EAAE,WAAW,EAAE,EAAE;GAI1B,MAAMC,YAA2C,EAAE;AACnD,QAAK,MAAM,CAAC,IAAI,UAAU,SAAS,MAAM,UACvC,WAAU,MAAM;AAElB,UAAO,EAAE,WAAW;IAEvB;EAED,KAAK,OAAO,GAAG,eAAe,CAC5B,WACE,YACA,cACA,OACA;GACA,MAAM,QAAQ,OAAO,yBAAyB,WAAW;AAGzD,UAAO,IAAI,OAAO,QAAQ,QAAQ;IAChC,MAAM,WAAW,QAAQ,IAAI,KAAK,WAAW;AAC7C,QAAI,SAAS,SAAS,OAAQ,QAAO;AACrC,WAAO,QAAQ,IAAI,KAAK,8CACnB,SAAS,cACZ,WAAW,QAAQ,IACjB,SAAS,MAAM,WACf,cACA,MACD,IACD;KACF;AAGF,UAAO,OAAO,UAAUC,gBAAwB;AAChD,UAAO,OAAO,YAAYC,gBAAwB,EAAE;GAGpD,MAAMC,QAAuB;IAC3B,MAAM;IACN,IAAI;IACJ,MAAM,MAAM;IACZ,QAAQ,MAAM;IACf;AACD,UAAO,OAAO,QAAQ,MAAM,QAAQ,MAAM;IAE7C;EAED,QAAQ,OAAO,GAAG,kBAAkB,CAClC,WAAW,YAAoB,cAAsB;GACnD,MAAM,UAAU,OAAO,IAAI,IAAI,MAAM;GACrC,MAAM,WAAW,QAAQ,IAAI,SAAS,WAAW;AACjD,OAAI,SAAS,SAAS,OAAQ;AAO9B,OAAI,CAJgB,QAAQ,IAC1B,SAAS,MAAM,WACf,aACD,CACiB;AAGlB,UAAO,IAAI,OAAO,QAAQ,QAAQ;IAChC,MAAM,WAAW,QAAQ,IAAI,KAAK,WAAW;AAC7C,QAAI,SAAS,SAAS,OAAQ,QAAO;AACrC,WAAO,QAAQ,IAAI,KAAK,8CACnB,SAAS,cACZ,WAAW,QAAQ,OAAO,SAAS,MAAM,WAAW,aAAa,IACjE;KACF;AAGF,UAAO,OAAO,YAAYD,gBAAwB,GAAG;GAGrD,MAAMC,QAAuB;IAC3B,MAAM;IACN,IAAI;IACL;AACD,UAAO,OAAO,QAAQ,SAAS,MAAM,QAAQ,MAAM;IAEtD;EAED,WAAW,OAAO,GAAG,qBAAqB,CACxC,WAAW,YAAoB;GAC7B,MAAM,QAAQ,OAAO,yBAAyB,WAAW;AACzD,UAAO,OAAO,WAAW,MAAM,OAAO;IAEzC;EACF;EACD,CACH;AAMD,MAAa,kBAAkB;CAC7B,KAAK;CACL;CACD"}

package/dist/Protocol.d.cts

@@ -199,5 +199,5 @@ declare const presenceRemoveMessage: (id: string) => PresenceRemoveMessage;
  */
 declare const presenceSnapshotMessage: (selfId: string, presences: Record<string, PresenceEntry>) => PresenceSnapshotMessage;
 //#endregion
-export { Protocol_d_exports, ServerBroadcast, ServerMessage, SnapshotMessage };
+export { Protocol_d_exports, ServerBroadcast, ServerMessage };
 //# sourceMappingURL=Protocol.d.cts.map

package/dist/Protocol.d.mts

@@ -199,5 +199,5 @@ declare const presenceRemoveMessage: (id: string) => PresenceRemoveMessage;
  */
 declare const presenceSnapshotMessage: (selfId: string, presences: Record<string, PresenceEntry>) => PresenceSnapshotMessage;
 //#endregion
-export { Protocol_d_exports, ServerBroadcast, ServerMessage, SnapshotMessage };
+export { Protocol_d_exports, ServerBroadcast, ServerMessage };
 //# sourceMappingURL=Protocol.d.mts.map

package/dist/Types.d.cts

@@ -85,9 +85,15 @@ type DurationInput = Duration.DurationInput;
  */
 interface SnapshotConfig {
   /** Time-based snapshot interval */
-  readonly interval: DurationInput;
+  readonly interval?: DurationInput;
   /** Transaction count threshold for snapshots */
-  readonly transactionThreshold: number;
+  readonly transactionThreshold?: number;
+  /**
+   * Trigger snapshot when document is idle (no transactions) for this duration.
+   * Set to 0 to disable idle snapshots.
+   * Default: 30 seconds
+   */
+  readonly idleTimeout?: DurationInput;
 }
 /**
  * Context passed to initial state function
@@ -150,6 +156,7 @@ interface ResolvedConfig<TSchema extends Primitive.AnyPrimitive> {
   readonly snapshot: {
     readonly interval: Duration.Duration;
     readonly transactionThreshold: number;
+    readonly idleTimeout: Duration.Duration;
   };
 }
 /**

package/dist/Types.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"Types.d.cts","names":[],"sources":["../src/Types.ts"],"sourcesContent":[],"mappings":";;;;;AAiDA;AAgBA;AAUA;AAOA;AAUA;AAQY,KAnFA,UAAA,GAmFa,MAAA,GAAG,OAAA;AAS5B;AAKA;AAUA;AAOY,UA7GK,WAAA,CA6GI;EAAiB,SAAU,MAAA,EAAA,MAAA;EACrC,SAAA,UAAA,EA5GY,UA4GZ;EACgC,SAAA,QAAA,CAAA,EA5GrB,MA4GqB,CAAA,MAAA,EAAA,OAAA,CAAA;;;;AAK3C;AAAoC,UAvGnB,cAAA,CAuG6B;EAClB;EAAxB,SAAU,KAAA,EAAA,OAAA;EACA;EAAV,SAAA,OAAA,EAAA,MAAA;EAAS;EAKI,SAAA,aAAA,EAAA,MAAuB;EACtB;EAGC,SAAA,OAAA,EAAA,MAAA;;;;;AAeG,UAnHL,QAAA,CAmHK;EAAc;EAMnB,SAAA,WAAA,EAvHO,WAAA,CAAY,WAuHW;EAC7B;EACgB,SAAA,OAAA,EAAA,MAAA;EAAxB;EAAuB,SAAA,SAAA,EAAA,MAAA;AAYjC;AAkBA;;;AAE4B,UA3IX,aAAA,CA2IW;EAAR;EACC,SAAS,IAAA,EAAA,OAAA;EACN;EAGD,SAAS,MAAA,CAAA,EAAA,MAAA;;AAQhC;AASA;;AACyB,UAxJR,gBAAA,CAwJQ;EAAf,SAAA,SAAA,EAvJY,MAuJZ,CAAA,MAAA,EAvJ2B,aAuJ3B,CAAA;;;;;UAjJO,mBAAA;;;;;;;;;UAUA,mBAAA;;;;;;;KAQL,aAAA,GAAgB,sBAAsB;;;;KAStC,aAAA,GAAgB,QAAA,CAAS;;;;UAKpB,cAAA;;qBAEI;;;;;;;UAQJ,cAAA;;;;;;KAOL,0BAA0B,SAAA,CAAU,0BACrC,mBACN,MAAA,CAAO,OAAO,SAAA,CAAU,cAAc;;;;KAK/B,wBAAwB,SAAA,CAAU,gBAC1C,SAAA,CAAU,cAAc,WACxB,UAAU;;;;UAKG,wCACC,SAAA,CAAU;;mBAGT;;qBAGE,QAAQ;;sBAGP,QAAA,CAAS;;yBAGN;;;;sBAMH;;;;;UAML,+CACC,SAAA,CAAU,sBAClB,wBAAwB;;;;;;;UAYjB,sBAAA;;;;+BAKc;;8BAGD;;;;;UAUb,+BAA+B,SAAA,CAAU;mBACvC;oBACC,QAAQ;qBACP,QAAA,CAAS;wBACN,QAAA,CAAS;;;uBAGV,QAAA,CAAS;;;;;;;UAQf,mBAAA;;8BAEa,QAAA,CAAS;6BACV,QAAA,CAAS;;;;;UAMrB,sCAAsC,SAAA,CAAU,sBACvD,eAAe"}
+{"version":3,"file":"Types.d.cts","names":[],"sources":["../src/Types.ts"],"sourcesContent":[],"mappings":";;;;;AAiDA;AAgBA;AAUA;AAOA;AAUA;AAQY,KAnFA,UAAA,GAmFa,MAAA,GAAG,OAAA;AAS5B;AAKA;AAgBA;AAOY,UAnHK,WAAA,CAmHI;EAAiB,SAAU,MAAA,EAAA,MAAA;EACrC,SAAA,UAAA,EAlHY,UAkHZ;EACgC,SAAA,QAAA,CAAA,EAlHrB,MAkHqB,CAAA,MAAA,EAAA,OAAA,CAAA;;;;AAK3C;AAAoC,UA7GnB,cAAA,CA6G6B;EAClB;EAAxB,SAAU,KAAA,EAAA,OAAA;EACA;EAAV,SAAA,OAAA,EAAA,MAAA;EAAS;EAKI,SAAA,aAAA,EAAA,MAAuB;EACtB;EAGC,SAAA,OAAA,EAAA,MAAA;;;;;AAeG,UAzHL,QAAA,CAyHK;EAAc;EAMnB,SAAA,WAAA,EA7HO,WAAA,CAAY,WA6HW;EAC7B;EACgB,SAAA,OAAA,EAAA,MAAA;EAAxB;EAAuB,SAAA,SAAA,EAAA,MAAA;AAYjC;AAkBA;;;AAE4B,UAjJX,aAAA,CAiJW;EAAR;EACC,SAAS,IAAA,EAAA,OAAA;EACN;EAGD,SAAS,MAAA,CAAA,EAAA,MAAA;;;AAShC;AASA;AAAuD,UA9JtC,gBAAA,CA8JgD;EACxC,SAAA,SAAA,EA9JH,MA8JG,CAAA,MAAA,EA9JY,aA8JZ,CAAA;;;;;UAxJR,mBAAA;;;;;;;;;UAUA,mBAAA;;;;;;;KAQL,aAAA,GAAgB,sBAAsB;;;;KAStC,aAAA,GAAgB,QAAA,CAAS;;;;UAKpB,cAAA;;sBAEK;;;;;;;;yBAQG;;;;;UAMR,cAAA;;;;;;KAOL,0BAA0B,SAAA,CAAU,0BACrC,mBACN,MAAA,CAAO,OAAO,SAAA,CAAU,cAAc;;;;KAK/B,wBAAwB,SAAA,CAAU,gBAC1C,SAAA,CAAU,cAAc,WACxB,UAAU;;;;UAKG,wCACC,SAAA,CAAU;;mBAGT;;qBAGE,QAAQ;;sBAGP,QAAA,CAAS;;yBAGN;;;;sBAMH;;;;;UAML,+CACC,SAAA,CAAU,sBAClB,wBAAwB;;;;;;;UAYjB,sBAAA;;;;+BAKc;;8BAGD;;;;;UAUb,+BAA+B,SAAA,CAAU;mBACvC;oBACC,QAAQ;qBACP,QAAA,CAAS;wBACN,QAAA,CAAS;;;uBAGV,QAAA,CAAS;;0BAEN,QAAA,CAAS;;;;;;UAOlB,mBAAA;;8BAEa,QAAA,CAAS;6BACV,QAAA,CAAS;;;;;UAMrB,sCAAsC,SAAA,CAAU,sBACvD,eAAe"}

package/dist/Types.d.mts

@@ -85,9 +85,15 @@ type DurationInput = Duration.DurationInput;
  */
 interface SnapshotConfig {
   /** Time-based snapshot interval */
-  readonly interval: DurationInput;
+  readonly interval?: DurationInput;
   /** Transaction count threshold for snapshots */
-  readonly transactionThreshold: number;
+  readonly transactionThreshold?: number;
+  /**
+   * Trigger snapshot when document is idle (no transactions) for this duration.
+   * Set to 0 to disable idle snapshots.
+   * Default: 30 seconds
+   */
+  readonly idleTimeout?: DurationInput;
 }
 /**
  * Context passed to initial state function
@@ -150,6 +156,7 @@ interface ResolvedConfig<TSchema extends Primitive.AnyPrimitive> {
   readonly snapshot: {
     readonly interval: Duration.Duration;
     readonly transactionThreshold: number;
+    readonly idleTimeout: Duration.Duration;
   };
 }
 /**

package/dist/Types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"Types.d.mts","names":[],"sources":["../src/Types.ts"],"sourcesContent":[],"mappings":";;;;;AAiDA;AAgBA;AAUA;AAOA;AAUA;AAQY,KAnFA,UAAA,GAmFa,MAAA,GAAG,OAAA;AAS5B;AAKA;AAUA;AAOY,UA7GK,WAAA,CA6GI;EAAiB,SAAU,MAAA,EAAA,MAAA;EACrC,SAAA,UAAA,EA5GY,UA4GZ;EACgC,SAAA,QAAA,CAAA,EA5GrB,MA4GqB,CAAA,MAAA,EAAA,OAAA,CAAA;;;;AAK3C;AAAoC,UAvGnB,cAAA,CAuG6B;EAClB;EAAxB,SAAU,KAAA,EAAA,OAAA;EACA;EAAV,SAAA,OAAA,EAAA,MAAA;EAAS;EAKI,SAAA,aAAA,EAAA,MAAuB;EACtB;EAGC,SAAA,OAAA,EAAA,MAAA;;;;;AAeG,UAnHL,QAAA,CAmHK;EAAc;EAMnB,SAAA,WAAA,EAvHO,WAAA,CAAY,WAuHW;EAC7B;EACgB,SAAA,OAAA,EAAA,MAAA;EAAxB;EAAuB,SAAA,SAAA,EAAA,MAAA;AAYjC;AAkBA;;;AAE4B,UA3IX,aAAA,CA2IW;EAAR;EACC,SAAS,IAAA,EAAA,OAAA;EACN;EAGD,SAAS,MAAA,CAAA,EAAA,MAAA;;AAQhC;AASA;;AACyB,UAxJR,gBAAA,CAwJQ;EAAf,SAAA,SAAA,EAvJY,MAuJZ,CAAA,MAAA,EAvJ2B,aAuJ3B,CAAA;;;;;UAjJO,mBAAA;;;;;;;;;UAUA,mBAAA;;;;;;;KAQL,aAAA,GAAgB,sBAAsB;;;;KAStC,aAAA,GAAgB,QAAA,CAAS;;;;UAKpB,cAAA;;qBAEI;;;;;;;UAQJ,cAAA;;;;;;KAOL,0BAA0B,SAAA,CAAU,0BACrC,mBACN,MAAA,CAAO,OAAO,SAAA,CAAU,cAAc;;;;KAK/B,wBAAwB,SAAA,CAAU,gBAC1C,SAAA,CAAU,cAAc,WACxB,UAAU;;;;UAKG,wCACC,SAAA,CAAU;;mBAGT;;qBAGE,QAAQ;;sBAGP,QAAA,CAAS;;yBAGN;;;;sBAMH;;;;;UAML,+CACC,SAAA,CAAU,sBAClB,wBAAwB;;;;;;;UAYjB,sBAAA;;;;+BAKc;;8BAGD;;;;;UAUb,+BAA+B,SAAA,CAAU;mBACvC;oBACC,QAAQ;qBACP,QAAA,CAAS;wBACN,QAAA,CAAS;;;uBAGV,QAAA,CAAS;;;;;;;UAQf,mBAAA;;8BAEa,QAAA,CAAS;6BACV,QAAA,CAAS;;;;;UAMrB,sCAAsC,SAAA,CAAU,sBACvD,eAAe"}
+{"version":3,"file":"Types.d.mts","names":[],"sources":["../src/Types.ts"],"sourcesContent":[],"mappings":";;;;;AAiDA;AAgBA;AAUA;AAOA;AAUA;AAQY,KAnFA,UAAA,GAmFa,MAAA,GAAG,OAAA;AAS5B;AAKA;AAgBA;AAOY,UAnHK,WAAA,CAmHI;EAAiB,SAAU,MAAA,EAAA,MAAA;EACrC,SAAA,UAAA,EAlHY,UAkHZ;EACgC,SAAA,QAAA,CAAA,EAlHrB,MAkHqB,CAAA,MAAA,EAAA,OAAA,CAAA;;;;AAK3C;AAAoC,UA7GnB,cAAA,CA6G6B;EAClB;EAAxB,SAAU,KAAA,EAAA,OAAA;EACA;EAAV,SAAA,OAAA,EAAA,MAAA;EAAS;EAKI,SAAA,aAAA,EAAA,MAAuB;EACtB;EAGC,SAAA,OAAA,EAAA,MAAA;;;;;AAeG,UAzHL,QAAA,CAyHK;EAAc;EAMnB,SAAA,WAAA,EA7HO,WAAA,CAAY,WA6HW;EAC7B;EACgB,SAAA,OAAA,EAAA,MAAA;EAAxB;EAAuB,SAAA,SAAA,EAAA,MAAA;AAYjC;AAkBA;;;AAE4B,UAjJX,aAAA,CAiJW;EAAR;EACC,SAAS,IAAA,EAAA,OAAA;EACN;EAGD,SAAS,MAAA,CAAA,EAAA,MAAA;;;AAShC;AASA;AAAuD,UA9JtC,gBAAA,CA8JgD;EACxC,SAAA,SAAA,EA9JH,MA8JG,CAAA,MAAA,EA9JY,aA8JZ,CAAA;;;;;UAxJR,mBAAA;;;;;;;;;UAUA,mBAAA;;;;;;;KAQL,aAAA,GAAgB,sBAAsB;;;;KAStC,aAAA,GAAgB,QAAA,CAAS;;;;UAKpB,cAAA;;sBAEK;;;;;;;;yBAQG;;;;;UAMR,cAAA;;;;;;KAOL,0BAA0B,SAAA,CAAU,0BACrC,mBACN,MAAA,CAAO,OAAO,SAAA,CAAU,cAAc;;;;KAK/B,wBAAwB,SAAA,CAAU,gBAC1C,SAAA,CAAU,cAAc,WACxB,UAAU;;;;UAKG,wCACC,SAAA,CAAU;;mBAGT;;qBAGE,QAAQ;;sBAGP,QAAA,CAAS;;yBAGN;;;;sBAMH;;;;;UAML,+CACC,SAAA,CAAU,sBAClB,wBAAwB;;;;;;;UAYjB,sBAAA;;;;+BAKc;;8BAGD;;;;;UAUb,+BAA+B,SAAA,CAAU;mBACvC;oBACC,QAAQ;qBACP,QAAA,CAAS;wBACN,QAAA,CAAS;;;uBAGV,QAAA,CAAS;;0BAEN,QAAA,CAAS;;;;;;UAOlB,mBAAA;;8BAEa,QAAA,CAAS;6BACV,QAAA,CAAS;;;;;UAMrB,sCAAsC,SAAA,CAAU,sBACvD,eAAe"}

package/dist/index.cjs

@@ -1,11 +1,11 @@
 const require_ColdStorage = require('./ColdStorage.cjs');
+const require_Errors = require('./Errors.cjs');
 const require_HotStorage = require('./HotStorage.cjs');
 const require_Metrics = require('./Metrics.cjs');
-const require_DocumentManager = require('./DocumentManager.cjs');
+const require_DocumentInstance = require('./DocumentInstance.cjs');
 const require_PresenceManager = require('./PresenceManager.cjs');
 const require_MimicServerEngine = require('./MimicServerEngine.cjs');
 const require_MimicClusterServerEngine = require('./MimicClusterServerEngine.cjs');
-const require_Errors = require('./Errors.cjs');
 const require_Protocol = require('./Protocol.cjs');
 const require_MimicAuthService = require('./MimicAuthService.cjs');
 const require_MimicServer = require('./MimicServer.cjs');
@@ -15,9 +15,7 @@ exports.AuthorizationError = require_Errors.AuthorizationError;
 exports.ColdStorage = require_ColdStorage.ColdStorage;
 exports.ColdStorageError = require_Errors.ColdStorageError;
 exports.ColdStorageTag = require_ColdStorage.ColdStorageTag;
-exports.DocumentManager = require_DocumentManager.DocumentManager;
-exports.DocumentManagerConfigTag = require_DocumentManager.DocumentManagerConfigTag;
-exports.DocumentManagerTag = require_DocumentManager.DocumentManagerTag;
+exports.DocumentInstance = require_DocumentInstance.DocumentInstance;
 exports.HotStorage = require_HotStorage.HotStorage;
 exports.HotStorageError = require_Errors.HotStorageError;
 exports.HotStorageTag = require_HotStorage.HotStorageTag;
@@ -38,4 +36,5 @@ Object.defineProperty(exports, 'Protocol', {
     return require_Protocol.Protocol_exports;
   }
 });
-exports.TransactionRejectedError = require_Errors.TransactionRejectedError;
+exports.TransactionRejectedError = require_Errors.TransactionRejectedError;
+exports.WalVersionGapError = require_Errors.WalVersionGapError;

package/dist/index.d.cts

@@ -1,13 +1,13 @@
 import { AuthContext, DurationInput, Initial, InitialContext, InitialFn, MimicClusterServerEngineConfig, MimicServerEngineConfig, MimicServerRouteConfig, Permission, PresenceEntry, PresenceEvent, PresenceRemoveEvent, PresenceSnapshot, PresenceUpdateEvent, ResolvedClusterConfig, ResolvedConfig, ResolvedRouteConfig, SnapshotConfig, StoredDocument, WalEntry } from "./Types.cjs";
-import { AuthenticationError, AuthorizationError, ColdStorageError, HotStorageError, MessageParseError, MimicError, MissingDocumentIdError, TransactionRejectedError } from "./Errors.cjs";
+import { AuthenticationError, AuthorizationError, ColdStorageError, HotStorageError, MessageParseError, MimicError, MissingDocumentIdError, TransactionRejectedError, WalVersionGapError } from "./Errors.cjs";
 import { Protocol_d_exports } from "./Protocol.cjs";
 import { ColdStorage, ColdStorageTag } from "./ColdStorage.cjs";
 import { HotStorage, HotStorageTag } from "./HotStorage.cjs";
 import { MimicAuthService, MimicAuthServiceTag } from "./MimicAuthService.cjs";
-import { DocumentManager, DocumentManagerConfigTag, DocumentManagerTag, SubmitResult } from "./DocumentManager.cjs";
+import { DocumentInstance, SubmitResult } from "./DocumentInstance.cjs";
 import { MimicServerEngine, MimicServerEngineTag } from "./MimicServerEngine.cjs";
 import { MimicClusterServerEngine } from "./MimicClusterServerEngine.cjs";
 import { MimicServer } from "./MimicServer.cjs";
 import { MimicMetrics } from "./Metrics.cjs";
 import { PresenceManager, PresenceManagerTag } from "./PresenceManager.cjs";
-export { type AuthContext, AuthenticationError, AuthorizationError, ColdStorage, ColdStorageError, ColdStorageTag, DocumentManager, DocumentManagerConfigTag, DocumentManagerTag, type DurationInput, HotStorage, HotStorageError, HotStorageTag, type Initial, type InitialContext, type InitialFn, MessageParseError, MimicAuthService, MimicAuthServiceTag, MimicClusterServerEngine, type MimicClusterServerEngineConfig, type MimicError, MimicMetrics, MimicServer, MimicServerEngine, type MimicServerEngineConfig, MimicServerEngineTag, type MimicServerRouteConfig, MissingDocumentIdError, type Permission, type PresenceEntry, type PresenceEvent, PresenceManager, PresenceManagerTag, type PresenceRemoveEvent, type PresenceSnapshot, type PresenceUpdateEvent, Protocol_d_exports as Protocol, type ResolvedClusterConfig, type ResolvedConfig, type ResolvedRouteConfig, type SnapshotConfig, type StoredDocument, type SubmitResult, TransactionRejectedError, type WalEntry };
+export { AuthContext, AuthenticationError, AuthorizationError, ColdStorage, ColdStorageError, ColdStorageTag, DocumentInstance, type DocumentInstance as DocumentInstanceInterface, DurationInput, HotStorage, HotStorageError, HotStorageTag, Initial, InitialContext, InitialFn, MessageParseError, MimicAuthService, MimicAuthServiceTag, MimicClusterServerEngine, MimicClusterServerEngineConfig, MimicError, MimicMetrics, MimicServer, MimicServerEngine, MimicServerEngineConfig, MimicServerEngineTag, type MimicServerRouteConfig, MissingDocumentIdError, Permission, PresenceEntry, PresenceEvent, PresenceManager, PresenceManagerTag, PresenceRemoveEvent, PresenceSnapshot, PresenceUpdateEvent, Protocol_d_exports as Protocol, ResolvedClusterConfig, ResolvedConfig, ResolvedRouteConfig, SnapshotConfig, StoredDocument, type SubmitResult, TransactionRejectedError, WalEntry, WalVersionGapError };

package/dist/index.d.mts

@@ -1,13 +1,13 @@
 import { AuthContext, DurationInput, Initial, InitialContext, InitialFn, MimicClusterServerEngineConfig, MimicServerEngineConfig, MimicServerRouteConfig, Permission, PresenceEntry, PresenceEvent, PresenceRemoveEvent, PresenceSnapshot, PresenceUpdateEvent, ResolvedClusterConfig, ResolvedConfig, ResolvedRouteConfig, SnapshotConfig, StoredDocument, WalEntry } from "./Types.mjs";
-import { AuthenticationError, AuthorizationError, ColdStorageError, HotStorageError, MessageParseError, MimicError, MissingDocumentIdError, TransactionRejectedError } from "./Errors.mjs";
+import { AuthenticationError, AuthorizationError, ColdStorageError, HotStorageError, MessageParseError, MimicError, MissingDocumentIdError, TransactionRejectedError, WalVersionGapError } from "./Errors.mjs";
 import { Protocol_d_exports } from "./Protocol.mjs";
 import { ColdStorage, ColdStorageTag } from "./ColdStorage.mjs";
 import { HotStorage, HotStorageTag } from "./HotStorage.mjs";
 import { MimicAuthService, MimicAuthServiceTag } from "./MimicAuthService.mjs";
-import { DocumentManager, DocumentManagerConfigTag, DocumentManagerTag, SubmitResult } from "./DocumentManager.mjs";
+import { DocumentInstance, SubmitResult } from "./DocumentInstance.mjs";
 import { MimicServerEngine, MimicServerEngineTag } from "./MimicServerEngine.mjs";
 import { MimicClusterServerEngine } from "./MimicClusterServerEngine.mjs";
 import { MimicServer } from "./MimicServer.mjs";
 import { MimicMetrics } from "./Metrics.mjs";
 import { PresenceManager, PresenceManagerTag } from "./PresenceManager.mjs";
-export { type AuthContext, AuthenticationError, AuthorizationError, ColdStorage, ColdStorageError, ColdStorageTag, DocumentManager, DocumentManagerConfigTag, DocumentManagerTag, type DurationInput, HotStorage, HotStorageError, HotStorageTag, type Initial, type InitialContext, type InitialFn, MessageParseError, MimicAuthService, MimicAuthServiceTag, MimicClusterServerEngine, type MimicClusterServerEngineConfig, type MimicError, MimicMetrics, MimicServer, MimicServerEngine, type MimicServerEngineConfig, MimicServerEngineTag, type MimicServerRouteConfig, MissingDocumentIdError, type Permission, type PresenceEntry, type PresenceEvent, PresenceManager, PresenceManagerTag, type PresenceRemoveEvent, type PresenceSnapshot, type PresenceUpdateEvent, Protocol_d_exports as Protocol, type ResolvedClusterConfig, type ResolvedConfig, type ResolvedRouteConfig, type SnapshotConfig, type StoredDocument, type SubmitResult, TransactionRejectedError, type WalEntry };
+export { AuthContext, AuthenticationError, AuthorizationError, ColdStorage, ColdStorageError, ColdStorageTag, DocumentInstance, type DocumentInstance as DocumentInstanceInterface, DurationInput, HotStorage, HotStorageError, HotStorageTag, Initial, InitialContext, InitialFn, MessageParseError, MimicAuthService, MimicAuthServiceTag, MimicClusterServerEngine, MimicClusterServerEngineConfig, MimicError, MimicMetrics, MimicServer, MimicServerEngine, MimicServerEngineConfig, MimicServerEngineTag, type MimicServerRouteConfig, MissingDocumentIdError, Permission, PresenceEntry, PresenceEvent, PresenceManager, PresenceManagerTag, PresenceRemoveEvent, PresenceSnapshot, PresenceUpdateEvent, Protocol_d_exports as Protocol, ResolvedClusterConfig, ResolvedConfig, ResolvedRouteConfig, SnapshotConfig, StoredDocument, type SubmitResult, TransactionRejectedError, WalEntry, WalVersionGapError };

package/dist/index.mjs

@@ -1,13 +1,13 @@
 import { ColdStorage, ColdStorageTag } from "./ColdStorage.mjs";
+import { AuthenticationError, AuthorizationError, ColdStorageError, HotStorageError, MessageParseError, MissingDocumentIdError, TransactionRejectedError, WalVersionGapError } from "./Errors.mjs";
 import { HotStorage, HotStorageTag } from "./HotStorage.mjs";
 import { MimicMetrics } from "./Metrics.mjs";
-import { DocumentManager, DocumentManagerConfigTag, DocumentManagerTag } from "./DocumentManager.mjs";
+import { DocumentInstance } from "./DocumentInstance.mjs";
 import { PresenceManager, PresenceManagerTag } from "./PresenceManager.mjs";
 import { MimicServerEngine, MimicServerEngineTag } from "./MimicServerEngine.mjs";
 import { MimicClusterServerEngine } from "./MimicClusterServerEngine.mjs";
-import { AuthenticationError, AuthorizationError, ColdStorageError, HotStorageError, MessageParseError, MissingDocumentIdError, TransactionRejectedError } from "./Errors.mjs";
 import { Protocol_exports } from "./Protocol.mjs";
 import { MimicAuthService, MimicAuthServiceTag } from "./MimicAuthService.mjs";
 import { MimicServer } from "./MimicServer.mjs";
 
-export { AuthenticationError, AuthorizationError, ColdStorage, ColdStorageError, ColdStorageTag, DocumentManager, DocumentManagerConfigTag, DocumentManagerTag, HotStorage, HotStorageError, HotStorageTag, MessageParseError, MimicAuthService, MimicAuthServiceTag, MimicClusterServerEngine, MimicMetrics, MimicServer, MimicServerEngine, MimicServerEngineTag, MissingDocumentIdError, PresenceManager, PresenceManagerTag, Protocol_exports as Protocol, TransactionRejectedError };
+export { AuthenticationError, AuthorizationError, ColdStorage, ColdStorageError, ColdStorageTag, DocumentInstance, HotStorage, HotStorageError, HotStorageTag, MessageParseError, MimicAuthService, MimicAuthServiceTag, MimicClusterServerEngine, MimicMetrics, MimicServer, MimicServerEngine, MimicServerEngineTag, MissingDocumentIdError, PresenceManager, PresenceManagerTag, Protocol_exports as Protocol, TransactionRejectedError, WalVersionGapError };