@voidhash/mimic-effect 0.0.3 → 0.0.5

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @voidhash/mimic-effect@0.0.3 build /home/runner/work/mimic/mimic/packages/mimic-effect
+> @voidhash/mimic-effect@0.0.5 build /home/runner/work/mimic/mimic/packages/mimic-effect
 > tsdown
 
 ℹ tsdown v0.18.2 powered by rolldown v1.0.0-beta.55
@@ -9,15 +9,15 @@
 ℹ tsconfig: tsconfig.json
 ℹ Build start
 ℹ [CJS] dist/index.cjs                                                           2.79 kB │ gzip: 0.52 kB
-ℹ [CJS] dist/WebSocketHandler.cjs                                               13.86 kB │ gzip: 2.46 kB
-ℹ [CJS] dist/MimicServer.cjs                                                    10.22 kB │ gzip: 2.47 kB
-ℹ [CJS] dist/DocumentManager.cjs                                                 4.68 kB │ gzip: 1.38 kB
+ℹ [CJS] dist/WebSocketHandler.cjs                                               13.83 kB │ gzip: 2.46 kB
+ℹ [CJS] dist/MimicServer.cjs                                                     6.03 kB │ gzip: 1.82 kB
+ℹ [CJS] dist/DocumentManager.cjs                                                 4.75 kB │ gzip: 1.40 kB
 ℹ [CJS] dist/PresenceManager.cjs                                                 4.25 kB │ gzip: 1.19 kB
 ℹ [CJS] dist/MimicDataStorage.cjs                                                3.13 kB │ gzip: 0.96 kB
 ℹ [CJS] dist/DocumentProtocol.cjs                                                2.85 kB │ gzip: 0.79 kB
+ℹ [CJS] dist/MimicConfig.cjs                                                     2.77 kB │ gzip: 0.93 kB
 ℹ [CJS] dist/errors.cjs                                                          2.33 kB │ gzip: 0.63 kB
 ℹ [CJS] dist/storage/InMemoryDataStorage.cjs                                     2.21 kB │ gzip: 0.80 kB
-ℹ [CJS] dist/MimicConfig.cjs                                                     2.15 kB │ gzip: 0.74 kB
 ℹ [CJS] dist/MimicAuthService.cjs                                                2.12 kB │ gzip: 0.69 kB
 ℹ [CJS] dist/auth/NoAuth.cjs                                                     1.52 kB │ gzip: 0.63 kB
 ℹ [CJS] dist/_virtual/rolldown_runtime.cjs                                       1.31 kB │ gzip: 0.61 kB
@@ -26,12 +26,12 @@
 ℹ [CJS] dist/_virtual/_@oxc-project_runtime@0.103.0/helpers/toPrimitive.cjs      0.52 kB │ gzip: 0.32 kB
 ℹ [CJS] dist/_virtual/_@oxc-project_runtime@0.103.0/helpers/defineProperty.cjs   0.40 kB │ gzip: 0.24 kB
 ℹ [CJS] dist/_virtual/_@oxc-project_runtime@0.103.0/helpers/toPropertyKey.cjs    0.37 kB │ gzip: 0.23 kB
-ℹ [CJS] 18 files, total: 56.19 kB
+ℹ [CJS] 18 files, total: 52.65 kB
 ℹ [CJS] dist/MimicDataStorage.d.cts.map             1.96 kB │ gzip: 0.73 kB
 ℹ [CJS] dist/DocumentProtocol.d.cts.map             1.35 kB │ gzip: 0.52 kB
+ℹ [CJS] dist/MimicConfig.d.cts.map                  1.03 kB │ gzip: 0.51 kB
 ℹ [CJS] dist/MimicAuthService.d.cts.map             0.97 kB │ gzip: 0.51 kB
-ℹ [CJS] dist/MimicServer.d.cts.map                  0.95 kB │ gzip: 0.43 kB
-ℹ [CJS] dist/MimicConfig.d.cts.map                  0.77 kB │ gzip: 0.41 kB
+ℹ [CJS] dist/MimicServer.d.cts.map                  0.84 kB │ gzip: 0.44 kB
 ℹ [CJS] dist/errors.d.cts.map                       0.77 kB │ gzip: 0.36 kB
 ℹ [CJS] dist/WebSocketHandler.d.cts.map             0.74 kB │ gzip: 0.35 kB
 ℹ [CJS] dist/PresenceManager.d.cts.map              0.69 kB │ gzip: 0.36 kB
@@ -39,48 +39,48 @@
 ℹ [CJS] dist/storage/InMemoryDataStorage.d.cts.map  0.26 kB │ gzip: 0.18 kB
 ℹ [CJS] dist/auth/NoAuth.d.cts.map                  0.22 kB │ gzip: 0.17 kB
 ℹ [CJS] dist/index.d.cts                            1.52 kB │ gzip: 0.37 kB
-ℹ [CJS] dist/MimicServer.d.cts                      7.24 kB │ gzip: 2.01 kB
+ℹ [CJS] dist/MimicConfig.d.cts                      5.14 kB │ gzip: 1.43 kB
 ℹ [CJS] dist/MimicDataStorage.d.cts                 4.84 kB │ gzip: 1.19 kB
+ℹ [CJS] dist/MimicServer.d.cts                      4.62 kB │ gzip: 1.65 kB
 ℹ [CJS] dist/errors.d.cts                           4.08 kB │ gzip: 0.75 kB
 ℹ [CJS] dist/DocumentProtocol.d.cts                 3.78 kB │ gzip: 0.78 kB
-ℹ [CJS] dist/MimicConfig.d.cts                      3.47 kB │ gzip: 0.94 kB
 ℹ [CJS] dist/PresenceManager.d.cts                  3.00 kB │ gzip: 0.90 kB
 ℹ [CJS] dist/MimicAuthService.d.cts                 2.38 kB │ gzip: 0.77 kB
 ℹ [CJS] dist/DocumentManager.d.cts                  1.77 kB │ gzip: 0.63 kB
 ℹ [CJS] dist/WebSocketHandler.d.cts                 1.73 kB │ gzip: 0.63 kB
 ℹ [CJS] dist/auth/NoAuth.d.cts                      0.72 kB │ gzip: 0.40 kB
 ℹ [CJS] dist/storage/InMemoryDataStorage.d.cts      0.65 kB │ gzip: 0.33 kB
-ℹ [CJS] 23 files, total: 44.41 kB
-✔ Build complete in 5918ms
+ℹ [CJS] 23 files, total: 43.60 kB
+✔ Build complete in 5200ms
 ℹ [ESM] dist/index.mjs                                                           1.45 kB │ gzip: 0.36 kB
 ℹ [ESM] dist/WebSocketHandler.mjs.map                                           29.74 kB │ gzip: 5.00 kB
-ℹ [ESM] dist/MimicServer.mjs.map                                                15.45 kB │ gzip: 3.84 kB
-ℹ [ESM] dist/WebSocketHandler.mjs                                               12.38 kB │ gzip: 2.34 kB
+ℹ [ESM] dist/WebSocketHandler.mjs                                               12.36 kB │ gzip: 2.34 kB
+ℹ [ESM] dist/MimicServer.mjs.map                                                10.71 kB │ gzip: 3.31 kB
 ℹ [ESM] dist/PresenceManager.mjs.map                                            10.45 kB │ gzip: 2.54 kB
-ℹ [ESM] dist/DocumentManager.mjs.map                                             9.78 kB │ gzip: 2.79 kB
-ℹ [ESM] dist/MimicServer.mjs                                                     8.91 kB │ gzip: 2.35 kB
+ℹ [ESM] dist/DocumentManager.mjs.map                                             9.97 kB │ gzip: 2.85 kB
+ℹ [ESM] dist/MimicConfig.mjs.map                                                 7.76 kB │ gzip: 2.11 kB
 ℹ [ESM] dist/MimicDataStorage.mjs.map                                            6.27 kB │ gzip: 1.55 kB
-ℹ [ESM] dist/MimicConfig.mjs.map                                                 4.59 kB │ gzip: 1.25 kB
+ℹ [ESM] dist/MimicServer.mjs                                                     5.21 kB │ gzip: 1.72 kB
 ℹ [ESM] dist/MimicAuthService.mjs.map                                            4.09 kB │ gzip: 1.10 kB
 ℹ [ESM] dist/DocumentProtocol.mjs.map                                            4.07 kB │ gzip: 1.01 kB
-ℹ [ESM] dist/DocumentManager.mjs                                                 3.75 kB │ gzip: 1.25 kB
+ℹ [ESM] dist/DocumentManager.mjs                                                 3.81 kB │ gzip: 1.26 kB
 ℹ [ESM] dist/errors.mjs.map                                                      3.53 kB │ gzip: 0.92 kB
 ℹ [ESM] dist/PresenceManager.mjs                                                 3.38 kB │ gzip: 1.06 kB
 ℹ [ESM] dist/storage/InMemoryDataStorage.mjs.map                                 2.84 kB │ gzip: 1.03 kB
 ℹ [ESM] dist/MimicDataStorage.mjs                                                2.66 kB │ gzip: 0.87 kB
 ℹ [ESM] dist/DocumentProtocol.mjs                                                2.44 kB │ gzip: 0.73 kB
+ℹ [ESM] dist/MimicConfig.mjs                                                     2.25 kB │ gzip: 0.84 kB
 ℹ [ESM] dist/MimicDataStorage.d.mts.map                                          1.96 kB │ gzip: 0.73 kB
 ℹ [ESM] dist/errors.mjs                                                          1.95 kB │ gzip: 0.57 kB
 ℹ [ESM] dist/auth/NoAuth.mjs.map                                                 1.82 kB │ gzip: 0.68 kB
-ℹ [ESM] dist/MimicConfig.mjs                                                     1.75 kB │ gzip: 0.65 kB
 ℹ [ESM] dist/MimicAuthService.mjs                                                1.74 kB │ gzip: 0.61 kB
 ℹ [ESM] dist/storage/InMemoryDataStorage.mjs                                     1.68 kB │ gzip: 0.71 kB
 ℹ [ESM] dist/DocumentProtocol.d.mts.map                                          1.35 kB │ gzip: 0.52 kB
 ℹ [ESM] dist/auth/NoAuth.mjs                                                     1.21 kB │ gzip: 0.56 kB
+ℹ [ESM] dist/MimicConfig.d.mts.map                                               1.03 kB │ gzip: 0.51 kB
 ℹ [ESM] dist/MimicAuthService.d.mts.map                                          0.97 kB │ gzip: 0.51 kB
-ℹ [ESM] dist/MimicServer.d.mts.map                                               0.95 kB │ gzip: 0.43 kB
 ℹ [ESM] dist/_virtual/_@oxc-project_runtime@0.103.0/helpers/objectSpread2.mjs    0.90 kB │ gzip: 0.42 kB
-ℹ [ESM] dist/MimicConfig.d.mts.map                                               0.77 kB │ gzip: 0.41 kB
+ℹ [ESM] dist/MimicServer.d.mts.map                                               0.84 kB │ gzip: 0.44 kB
 ℹ [ESM] dist/errors.d.mts.map                                                    0.77 kB │ gzip: 0.36 kB
 ℹ [ESM] dist/WebSocketHandler.d.mts.map                                          0.74 kB │ gzip: 0.35 kB
 ℹ [ESM] dist/PresenceManager.d.mts.map                                           0.69 kB │ gzip: 0.36 kB
@@ -93,16 +93,16 @@
 ℹ [ESM] dist/storage/InMemoryDataStorage.d.mts.map                               0.26 kB │ gzip: 0.18 kB
 ℹ [ESM] dist/auth/NoAuth.d.mts.map                                               0.22 kB │ gzip: 0.17 kB
 ℹ [ESM] dist/index.d.mts                                                         1.52 kB │ gzip: 0.37 kB
-ℹ [ESM] dist/MimicServer.d.mts                                                   7.24 kB │ gzip: 2.01 kB
+ℹ [ESM] dist/MimicConfig.d.mts                                                   5.14 kB │ gzip: 1.42 kB
 ℹ [ESM] dist/MimicDataStorage.d.mts                                              4.84 kB │ gzip: 1.19 kB
+ℹ [ESM] dist/MimicServer.d.mts                                                   4.62 kB │ gzip: 1.65 kB
 ℹ [ESM] dist/errors.d.mts                                                        4.08 kB │ gzip: 0.75 kB
 ℹ [ESM] dist/DocumentProtocol.d.mts                                              3.78 kB │ gzip: 0.78 kB
-ℹ [ESM] dist/MimicConfig.d.mts                                                   3.47 kB │ gzip: 0.94 kB
 ℹ [ESM] dist/PresenceManager.d.mts                                               3.00 kB │ gzip: 0.90 kB
 ℹ [ESM] dist/MimicAuthService.d.mts                                              2.38 kB │ gzip: 0.77 kB
 ℹ [ESM] dist/DocumentManager.d.mts                                               1.77 kB │ gzip: 0.63 kB
 ℹ [ESM] dist/WebSocketHandler.d.mts                                              1.73 kB │ gzip: 0.63 kB
 ℹ [ESM] dist/auth/NoAuth.d.mts                                                   0.72 kB │ gzip: 0.40 kB
 ℹ [ESM] dist/storage/InMemoryDataStorage.d.mts                                   0.65 kB │ gzip: 0.33 kB
-ℹ [ESM] 52 files, total: 183.11 kB
-✔ Build complete in 5945ms
+ℹ [ESM] 52 files, total: 177.78 kB
+✔ Build complete in 5219ms

package/dist/DocumentManager.cjs

@@ -5,14 +5,14 @@ let effect_Effect = require("effect/Effect");
 effect_Effect = require_rolldown_runtime.__toESM(effect_Effect);
 let effect_Layer = require("effect/Layer");
 effect_Layer = require_rolldown_runtime.__toESM(effect_Layer);
-let effect_Context = require("effect/Context");
-effect_Context = require_rolldown_runtime.__toESM(effect_Context);
 let effect_PubSub = require("effect/PubSub");
 effect_PubSub = require_rolldown_runtime.__toESM(effect_PubSub);
 let effect_Ref = require("effect/Ref");
 effect_Ref = require_rolldown_runtime.__toESM(effect_Ref);
 let effect_HashMap = require("effect/HashMap");
 effect_HashMap = require_rolldown_runtime.__toESM(effect_HashMap);
+let effect_Context = require("effect/Context");
+effect_Context = require_rolldown_runtime.__toESM(effect_Context);
 let effect_Stream = require("effect/Stream");
 effect_Stream = require_rolldown_runtime.__toESM(effect_Stream);
 let _voidhash_mimic_server = require("@voidhash/mimic/server");
@@ -45,7 +45,7 @@ const makeDocumentManager = effect_Effect.gen(function* () {
 			return existing.value;
 		}
 		const rawState = yield* effect_Effect.catchAll(storage.load(documentId), () => effect_Effect.succeed(void 0));
-		const initialState = rawState !== void 0 ? yield* storage.onLoad(rawState) : void 0;
+		const initialState = rawState !== void 0 ? yield* storage.onLoad(rawState) : config.initial !== void 0 ? yield* config.initial({ documentId }) : void 0;
 		const pubsub = yield* effect_PubSub.unbounded();
 		const serverDocument = _voidhash_mimic_server.ServerDocument.make({
 			schema: config.schema,

package/dist/DocumentManager.d.cts

@@ -3,8 +3,8 @@ import { MimicServerConfigTag } from "./MimicConfig.cjs";
 import { MimicDataStorageTag } from "./MimicDataStorage.cjs";
 import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
-import * as Context from "effect/Context";
 import { Transaction } from "@voidhash/mimic";
+import * as Context from "effect/Context";
 import * as Scope from "effect/Scope";
 import * as Stream from "effect/Stream";
 

package/dist/DocumentManager.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"DocumentManager.d.cts","names":[],"sources":["../src/DocumentManager.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;UA2CiB,eAAA;EAAA;;;EAOV,SAAO,MAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,WAAA,EADG,WAAA,CAAY,WACf,EAAA,GAAP,MAAA,CAAO,MAAA,CAAO,YAAP,CAAA;EAOO;;;EASjB,SAAO,WAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,GATJ,MAAA,CAAO,MASH,CATU,eASV,CAAA;EAEP;;;AAEH;8CALM,MAAA,CAAO,OACV,MAAA,CAAO,OAAO,yBAEd,KAAA,CAAM;;cAET;;AAKD;AA4KA;AACE,cA7KW,kBAAA,SAA2B,uBAAA,CA6KtC;;;;;cADW,OAAO,KAAA,CAAM,MACxB,2BAEA,uBAAuB"}
+{"version":3,"file":"DocumentManager.d.cts","names":[],"sources":["../src/DocumentManager.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;UA2CiB,eAAA;EAAA;;;EAOV,SAAO,MAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,WAAA,EADG,WAAA,CAAY,WACf,EAAA,GAAP,MAAA,CAAO,MAAA,CAAO,YAAP,CAAA;EAOO;;;EASjB,SAAO,WAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,GATJ,MAAA,CAAO,MASH,CATU,eASV,CAAA;EAEP;;;AAEH;8CALM,MAAA,CAAO,OACV,MAAA,CAAO,OAAO,yBAEd,KAAA,CAAM;;cAET;;AAKD;AA8KA;AACE,cA/KW,kBAAA,SAA2B,uBAAA,CA+KtC;;;;;cADW,OAAO,KAAA,CAAM,MACxB,2BAEA,uBAAuB"}

package/dist/DocumentManager.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"DocumentManager.d.mts","names":[],"sources":["../src/DocumentManager.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;UA2CiB,eAAA;EAAA;;;EAOV,SAAO,MAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,WAAA,EADG,WAAA,CAAY,WACf,EAAA,GAAP,MAAA,CAAO,MAAA,CAAO,YAAP,CAAA;EAOO;;;EASjB,SAAO,WAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,GATJ,MAAA,CAAO,MASH,CATU,eASV,CAAA;EAEP;;;AAEH;8CALM,MAAA,CAAO,OACV,MAAA,CAAO,OAAO,yBAEd,KAAA,CAAM;;cAET;;AAKD;AA4KA;AACE,cA7KW,kBAAA,SAA2B,uBAAA,CA6KtC;;;;;cADW,OAAO,KAAA,CAAM,MACxB,2BAEA,uBAAuB"}
+{"version":3,"file":"DocumentManager.d.mts","names":[],"sources":["../src/DocumentManager.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;UA2CiB,eAAA;EAAA;;;EAOV,SAAO,MAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,WAAA,EADG,WAAA,CAAY,WACf,EAAA,GAAP,MAAA,CAAO,MAAA,CAAO,YAAP,CAAA;EAOO;;;EASjB,SAAO,WAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,GATJ,MAAA,CAAO,MASH,CATU,eASV,CAAA;EAEP;;;AAEH;8CALM,MAAA,CAAO,OACV,MAAA,CAAO,OAAO,yBAEd,KAAA,CAAM;;cAET;;AAKD;AA8KA;AACE,cA/KW,kBAAA,SAA2B,uBAAA,CA+KtC;;;;;cADW,OAAO,KAAA,CAAM,MACxB,2BAEA,uBAAuB"}

package/dist/DocumentManager.mjs

@@ -3,10 +3,10 @@ import { MimicServerConfigTag } from "./MimicConfig.mjs";
 import { MimicDataStorageTag } from "./MimicDataStorage.mjs";
 import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
-import * as Context from "effect/Context";
 import * as PubSub from "effect/PubSub";
 import * as Ref from "effect/Ref";
 import * as HashMap from "effect/HashMap";
+import * as Context from "effect/Context";
 import * as Stream from "effect/Stream";
 import { ServerDocument } from "@voidhash/mimic/server";
 
@@ -38,7 +38,7 @@ const makeDocumentManager = Effect.gen(function* () {
 			return existing.value;
 		}
 		const rawState = yield* Effect.catchAll(storage.load(documentId), () => Effect.succeed(void 0));
-		const initialState = rawState !== void 0 ? yield* storage.onLoad(rawState) : void 0;
+		const initialState = rawState !== void 0 ? yield* storage.onLoad(rawState) : config.initial !== void 0 ? yield* config.initial({ documentId }) : void 0;
 		const pubsub = yield* PubSub.unbounded();
 		const serverDocument = ServerDocument.make({
 			schema: config.schema,

package/dist/DocumentManager.mjs.map

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

package/dist/MimicConfig.cjs

@@ -1,10 +1,13 @@
 const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+let effect_Effect = require("effect/Effect");
+effect_Effect = require_rolldown_runtime.__toESM(effect_Effect);
 let effect_Layer = require("effect/Layer");
 effect_Layer = require_rolldown_runtime.__toESM(effect_Layer);
 let effect_Context = require("effect/Context");
 effect_Context = require_rolldown_runtime.__toESM(effect_Context);
 let effect_Duration = require("effect/Duration");
 effect_Duration = require_rolldown_runtime.__toESM(effect_Duration);
+let _voidhash_mimic = require("@voidhash/mimic");
 
 //#region src/MimicConfig.ts
 /**
@@ -17,17 +20,24 @@ var MimicConfig_exports = /* @__PURE__ */ require_rolldown_runtime.__export({
 	make: () => make
 });
 /**
+* Check if a value is an InitialFn (function) rather than a plain object.
+*/
+const isInitialFn = (value) => typeof value === "function";
+/**
 * Create a MimicServerConfig from options.
 */
 const make = (options) => {
 	var _options$maxIdleTime, _options$maxTransacti, _options$heartbeatInt, _options$heartbeatTim;
+	const { initial, schema } = options;
+	const initialFn = initial === void 0 ? void 0 : isInitialFn(initial) ? (context) => effect_Effect.map(initial(context), (state) => _voidhash_mimic.Primitive.applyDefaults(schema, state)) : () => effect_Effect.succeed(_voidhash_mimic.Primitive.applyDefaults(schema, initial));
 	return {
-		schema: options.schema,
+		schema,
 		maxIdleTime: effect_Duration.decode((_options$maxIdleTime = options.maxIdleTime) !== null && _options$maxIdleTime !== void 0 ? _options$maxIdleTime : "5 minutes"),
 		maxTransactionHistory: (_options$maxTransacti = options.maxTransactionHistory) !== null && _options$maxTransacti !== void 0 ? _options$maxTransacti : 1e3,
 		heartbeatInterval: effect_Duration.decode((_options$heartbeatInt = options.heartbeatInterval) !== null && _options$heartbeatInt !== void 0 ? _options$heartbeatInt : "30 seconds"),
 		heartbeatTimeout: effect_Duration.decode((_options$heartbeatTim = options.heartbeatTimeout) !== null && _options$heartbeatTim !== void 0 ? _options$heartbeatTim : "10 seconds"),
-		presence: options.presence
+		presence: options.presence,
+		initial: initialFn
 	};
 };
 /**

package/dist/MimicConfig.d.cts

@@ -1,13 +1,28 @@
+import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
-import * as Context from "effect/Context";
 import { Presence, Primitive } from "@voidhash/mimic";
+import * as Context from "effect/Context";
 import * as Duration from "effect/Duration";
 import { DurationInput } from "effect/Duration";
 
 //#region src/MimicConfig.d.ts
 declare namespace MimicConfig_d_exports {
-  export { MimicServerConfig, MimicServerConfigOptions, MimicServerConfigTag, layer, make };
+  export { InitialContext, InitialFn, MimicServerConfig, MimicServerConfigOptions, MimicServerConfigTag, layer, make };
+}
+/**
+ * Context available when computing initial state for a document.
+ */
+interface InitialContext {
+  /**
+   * The document ID being initialized.
+   */
+  readonly documentId: string;
 }
+/**
+ * Function that computes initial state for a document.
+ * Receives context with the document ID and returns an Effect that produces the initial state.
+ */
+type InitialFn<TSchema extends Primitive.AnyPrimitive> = (context: InitialContext) => Effect.Effect<Primitive.InferSetInput<TSchema>>;
 /**
  * Configuration for the Mimic server.
  *
@@ -45,6 +60,13 @@ interface MimicServerConfig<TSchema extends Primitive.AnyPrimitive = Primitive.A
    * @default undefined (presence disabled)
    */
   readonly presence: Presence.AnyPresence | undefined;
+  /**
+   * Initial state function for new documents.
+   * Called when a document is created and no existing state is found in storage.
+   * Receives the document ID and returns an Effect that produces the initial state.
+   * @default undefined (documents start empty or use schema defaults)
+   */
+  readonly initial: InitialFn<TSchema> | undefined;
 }
 /**
  * Options for creating a MimicServerConfig.
@@ -80,6 +102,26 @@ interface MimicServerConfigOptions<TSchema extends Primitive.AnyPrimitive = Prim
    * @default undefined (presence disabled)
    */
   readonly presence?: Presence.AnyPresence;
+  /**
+   * Initial state for new documents.
+   * Can be either:
+   * - A plain object with the initial state values
+   * - A function that receives context (with documentId) and returns an Effect producing the initial state
+   *
+   * Type-safe: required fields (without defaults) must be provided,
+   * while optional fields and fields with defaults can be omitted.
+   *
+   * @example
+   * // Plain object
+   * initial: { title: "New Document", count: 0 }
+   *
+   * @example
+   * // Function returning Effect
+   * initial: ({ documentId }) => Effect.succeed({ title: `Doc ${documentId}`, count: 0 })
+   *
+   * @default undefined (documents start empty or use schema defaults)
+   */
+  readonly initial?: Primitive.InferSetInput<TSchema> | InitialFn<TSchema>;
 }
 /**
  * Create a MimicServerConfig from options.
@@ -95,5 +137,5 @@ declare class MimicServerConfigTag extends MimicServerConfigTag_base {}
  */
 declare const layer: <TSchema extends Primitive.AnyPrimitive>(options: MimicServerConfigOptions<TSchema>) => Layer.Layer<MimicServerConfigTag>;
 //#endregion
-export { MimicConfig_d_exports, MimicServerConfigOptions, MimicServerConfigTag };
+export { InitialFn, MimicConfig_d_exports, MimicServerConfigOptions, MimicServerConfigTag };
 //# sourceMappingURL=MimicConfig.d.cts.map

package/dist/MimicConfig.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"MimicConfig.d.cts","names":[],"sources":["../src/MimicConfig.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;AAoBiB,UAAA,iBAAiB,CAAA,gBAAiB,SAAA,CAAU,YAA3B,GAA0C,SAAA,CAAU,YAApD,CAAA,CAAA;EAAiB;;;EAU3B,SAAS,MAAA,EANd,OAMc;EAYH;;;;EAmBb,SAAA,WAAA,EA/BO,QAAA,CAAS,QA+BQ;EAAiB;;;;EAsB3B,SAAA,qBAAA,EAAA,MAAA;EAMD;;;AAa9B;EAAqC,SAAU,iBAAA,EA5DjB,QAAA,CAAS,QA4DQ;EACX;;;;EAChB,SAAA,gBAAA,EAxDS,QAAA,CAAS,QAwDlB;EAOjB;;;;;qBAxDkB,QAAA,CAAS;AAiE9B;AAOA;;;AACW,UAnEM,wBAmEN,CAAA,gBAnE+C,SAAA,CAAU,YAmEzD,GAnEwE,SAAA,CAAU,YAmElF,CAAA,CAAA;EACI;;;mBAhEI;;;;;yBAMM;;;;;;;;;;+BAYM;;;;;8BAMD;;;;;;sBAOR,QAAA,CAAS;;;;;cAMlB,uBAAwB,SAAA,CAAU,uBACpC,yBAAyB,aACjC,kBAAkB;cAOlB;;;;cASU,oBAAA,SAA6B,yBAAA;;;;cAO7B,wBAAyB,SAAA,CAAU,uBACrC,yBAAyB,aACjC,KAAA,CAAM,MAAM"}
+{"version":3,"file":"MimicConfig.d.cts","names":[],"sources":["../src/MimicConfig.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;UAkBiB,cAAA;;;;;AAAjB;AAWA;;;;AAEmB,KAFP,SAEiB,CAAA,gBAFS,SAAA,CAAU,YAEnB,CAAA,GAAA,CAAA,OAAA,EADlB,cACkB,EAAA,GAAxB,MAAA,CAAO,MAAiB,CAAV,SAAA,CAAU,aAAA,CAAc,OAAd,CAAA,CAAA;;;AAY7B;;;;AAYwB,UAZP,iBAYgB,CAAA,gBAXf,SAAA,CAAU,YAWK,GAXU,SAAA,CAAU,YAWpB,CAAA,CAAA;EAYH;;;EAqBA,SAAA,MAAA,EAvCX,OAuCW;EAAV;;AAMpB;;EAC2C,SAAU,WAAA,EAxC7B,QAAA,CAAS,QAwCoB;EAKlC;;;;EA+BG,SAAS,qBAAA,EAAA,MAAA;EAqBc;;;;EAAoB,SAAA,iBAAA,EArFnC,QAAA,CAAS,QAqF0B;EAapD;;;;EAEQ,SAAA,gBAAA,EA9FQ,QAAA,CAAS,QA8FjB;EAAlB;;AAwBD;;;qBA/GmB,QAAA,CAAS;;;AAwH9B;AAOA;;;EACW,SAAA,OAAA,EAxHS,SAwHT,CAxHmB,OAwHnB,CAAA,GAAA,SAAA;;;;;UAlHM,yCACC,SAAA,CAAU,eAAe,SAAA,CAAU;;;;mBAKlC;;;;;yBAMM;;;;;;;;;;+BAYM;;;;;8BAMD;;;;;;sBAOR,QAAA,CAAS;;;;;;;;;;;;;;;;;;;;qBAqBV,SAAA,CAAU,cAAc,WAAW,UAAU;;;;;cAarD,uBAAwB,SAAA,CAAU,uBACpC,yBAAyB,aACjC,kBAAkB;cAwBnB;;;;cASW,oBAAA,SAA6B,yBAAA;;;;cAO7B,wBAAyB,SAAA,CAAU,uBACrC,yBAAyB,aACjC,KAAA,CAAM,MAAM"}

package/dist/MimicConfig.d.mts

@@ -1,3 +1,4 @@
+import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
 import * as Context from "effect/Context";
 import * as Duration from "effect/Duration";
@@ -6,8 +7,22 @@ import { Presence, Primitive } from "@voidhash/mimic";
 
 //#region src/MimicConfig.d.ts
 declare namespace MimicConfig_d_exports {
-  export { MimicServerConfig, MimicServerConfigOptions, MimicServerConfigTag, layer, make };
+  export { InitialContext, InitialFn, MimicServerConfig, MimicServerConfigOptions, MimicServerConfigTag, layer, make };
 }
+/**
+ * Context available when computing initial state for a document.
+ */
+interface InitialContext {
+  /**
+   * The document ID being initialized.
+   */
+  readonly documentId: string;
+}
+/**
+ * Function that computes initial state for a document.
+ * Receives context with the document ID and returns an Effect that produces the initial state.
+ */
+type InitialFn<TSchema extends Primitive.AnyPrimitive> = (context: InitialContext) => Effect.Effect<Primitive.InferSetInput<TSchema>>;
 /**
  * Configuration for the Mimic server.
  *
@@ -45,6 +60,13 @@ interface MimicServerConfig<TSchema extends Primitive.AnyPrimitive = Primitive.A
    * @default undefined (presence disabled)
    */
   readonly presence: Presence.AnyPresence | undefined;
+  /**
+   * Initial state function for new documents.
+   * Called when a document is created and no existing state is found in storage.
+   * Receives the document ID and returns an Effect that produces the initial state.
+   * @default undefined (documents start empty or use schema defaults)
+   */
+  readonly initial: InitialFn<TSchema> | undefined;
 }
 /**
  * Options for creating a MimicServerConfig.
@@ -80,6 +102,26 @@ interface MimicServerConfigOptions<TSchema extends Primitive.AnyPrimitive = Prim
    * @default undefined (presence disabled)
    */
   readonly presence?: Presence.AnyPresence;
+  /**
+   * Initial state for new documents.
+   * Can be either:
+   * - A plain object with the initial state values
+   * - A function that receives context (with documentId) and returns an Effect producing the initial state
+   *
+   * Type-safe: required fields (without defaults) must be provided,
+   * while optional fields and fields with defaults can be omitted.
+   *
+   * @example
+   * // Plain object
+   * initial: { title: "New Document", count: 0 }
+   *
+   * @example
+   * // Function returning Effect
+   * initial: ({ documentId }) => Effect.succeed({ title: `Doc ${documentId}`, count: 0 })
+   *
+   * @default undefined (documents start empty or use schema defaults)
+   */
+  readonly initial?: Primitive.InferSetInput<TSchema> | InitialFn<TSchema>;
 }
 /**
  * Create a MimicServerConfig from options.
@@ -95,5 +137,5 @@ declare class MimicServerConfigTag extends MimicServerConfigTag_base {}
  */
 declare const layer: <TSchema extends Primitive.AnyPrimitive>(options: MimicServerConfigOptions<TSchema>) => Layer.Layer<MimicServerConfigTag>;
 //#endregion
-export { MimicConfig_d_exports, MimicServerConfigOptions, MimicServerConfigTag };
+export { InitialFn, MimicConfig_d_exports, MimicServerConfigOptions, MimicServerConfigTag };
 //# sourceMappingURL=MimicConfig.d.mts.map

package/dist/MimicConfig.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"MimicConfig.d.mts","names":[],"sources":["../src/MimicConfig.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;AAoBiB,UAAA,iBAAiB,CAAA,gBAAiB,SAAA,CAAU,YAA3B,GAA0C,SAAA,CAAU,YAApD,CAAA,CAAA;EAAiB;;;EAU3B,SAAS,MAAA,EANd,OAMc;EAYH;;;;EAmBb,SAAA,WAAA,EA/BO,QAAA,CAAS,QA+BQ;EAAiB;;;;EAsB3B,SAAA,qBAAA,EAAA,MAAA;EAMD;;;AAa9B;EAAqC,SAAU,iBAAA,EA5DjB,QAAA,CAAS,QA4DQ;EACX;;;;EAChB,SAAA,gBAAA,EAxDS,QAAA,CAAS,QAwDlB;EAOjB;;;;;qBAxDkB,QAAA,CAAS;AAiE9B;AAOA;;;AACW,UAnEM,wBAmEN,CAAA,gBAnE+C,SAAA,CAAU,YAmEzD,GAnEwE,SAAA,CAAU,YAmElF,CAAA,CAAA;EACI;;;mBAhEI;;;;;yBAMM;;;;;;;;;;+BAYM;;;;;8BAMD;;;;;;sBAOR,QAAA,CAAS;;;;;cAMlB,uBAAwB,SAAA,CAAU,uBACpC,yBAAyB,aACjC,kBAAkB;cAOlB;;;;cASU,oBAAA,SAA6B,yBAAA;;;;cAO7B,wBAAyB,SAAA,CAAU,uBACrC,yBAAyB,aACjC,KAAA,CAAM,MAAM"}
+{"version":3,"file":"MimicConfig.d.mts","names":[],"sources":["../src/MimicConfig.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;UAkBiB,cAAA;;;;;AAAjB;AAWA;;;;AAEmB,KAFP,SAEiB,CAAA,gBAFS,SAAA,CAAU,YAEnB,CAAA,GAAA,CAAA,OAAA,EADlB,cACkB,EAAA,GAAxB,MAAA,CAAO,MAAiB,CAAV,SAAA,CAAU,aAAA,CAAc,OAAd,CAAA,CAAA;;;AAY7B;;;;AAYwB,UAZP,iBAYgB,CAAA,gBAXf,SAAA,CAAU,YAWK,GAXU,SAAA,CAAU,YAWpB,CAAA,CAAA;EAYH;;;EAqBA,SAAA,MAAA,EAvCX,OAuCW;EAAV;;AAMpB;;EAC2C,SAAU,WAAA,EAxC7B,QAAA,CAAS,QAwCoB;EAKlC;;;;EA+BG,SAAS,qBAAA,EAAA,MAAA;EAqBc;;;;EAAoB,SAAA,iBAAA,EArFnC,QAAA,CAAS,QAqF0B;EAapD;;;;EAEQ,SAAA,gBAAA,EA9FQ,QAAA,CAAS,QA8FjB;EAAlB;;AAwBD;;;qBA/GmB,QAAA,CAAS;;;AAwH9B;AAOA;;;EACW,SAAA,OAAA,EAxHS,SAwHT,CAxHmB,OAwHnB,CAAA,GAAA,SAAA;;;;;UAlHM,yCACC,SAAA,CAAU,eAAe,SAAA,CAAU;;;;mBAKlC;;;;;yBAMM;;;;;;;;;;+BAYM;;;;;8BAMD;;;;;;sBAOR,QAAA,CAAS;;;;;;;;;;;;;;;;;;;;qBAqBV,SAAA,CAAU,cAAc,WAAW,UAAU;;;;;cAarD,uBAAwB,SAAA,CAAU,uBACpC,yBAAyB,aACjC,kBAAkB;cAwBnB;;;;cASW,oBAAA,SAA6B,yBAAA;;;;cAO7B,wBAAyB,SAAA,CAAU,uBACrC,yBAAyB,aACjC,KAAA,CAAM,MAAM"}

package/dist/MimicConfig.mjs

@@ -1,7 +1,9 @@
 import { __export } from "./_virtual/rolldown_runtime.mjs";
+import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
 import * as Context from "effect/Context";
 import * as Duration from "effect/Duration";
+import { Primitive } from "@voidhash/mimic";
 
 //#region src/MimicConfig.ts
 /**
@@ -14,17 +16,24 @@ var MimicConfig_exports = /* @__PURE__ */ __export({
 	make: () => make
 });
 /**
+* Check if a value is an InitialFn (function) rather than a plain object.
+*/
+const isInitialFn = (value) => typeof value === "function";
+/**
 * Create a MimicServerConfig from options.
 */
 const make = (options) => {
 	var _options$maxIdleTime, _options$maxTransacti, _options$heartbeatInt, _options$heartbeatTim;
+	const { initial, schema } = options;
+	const initialFn = initial === void 0 ? void 0 : isInitialFn(initial) ? (context) => Effect.map(initial(context), (state) => Primitive.applyDefaults(schema, state)) : () => Effect.succeed(Primitive.applyDefaults(schema, initial));
 	return {
-		schema: options.schema,
+		schema,
 		maxIdleTime: Duration.decode((_options$maxIdleTime = options.maxIdleTime) !== null && _options$maxIdleTime !== void 0 ? _options$maxIdleTime : "5 minutes"),
 		maxTransactionHistory: (_options$maxTransacti = options.maxTransactionHistory) !== null && _options$maxTransacti !== void 0 ? _options$maxTransacti : 1e3,
 		heartbeatInterval: Duration.decode((_options$heartbeatInt = options.heartbeatInterval) !== null && _options$heartbeatInt !== void 0 ? _options$heartbeatInt : "30 seconds"),
 		heartbeatTimeout: Duration.decode((_options$heartbeatTim = options.heartbeatTimeout) !== null && _options$heartbeatTim !== void 0 ? _options$heartbeatTim : "10 seconds"),
-		presence: options.presence
+		presence: options.presence,
+		initial: initialFn
 	};
 };
 /**

package/dist/MimicConfig.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"MimicConfig.mjs","names":[],"sources":["../src/MimicConfig.ts"],"sourcesContent":["/**\n * @since 0.0.1\n * Configuration types for the Mimic server.\n */\nimport * as Context from \"effect/Context\";\nimport * as Duration from \"effect/Duration\";\nimport type { DurationInput } from \"effect/Duration\";\nimport * as Layer from \"effect/Layer\";\nimport type { Primitive, Presence } from \"@voidhash/mimic\";\n\n// =============================================================================\n// Mimic Server Configuration\n// =============================================================================\n\n/**\n * Configuration for the Mimic server.\n * \n * Note: Authentication and persistence are now handled by injectable services\n * (MimicAuthService and MimicDataStorage) rather than config options.\n */\nexport interface MimicServerConfig<TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive> {\n  /**\n   * The schema defining the document structure.\n   */\n  readonly schema: TSchema;\n\n  /**\n   * Maximum idle time for a document before it is cleaned up.\n   * @default \"5 minutes\"\n   */\n  readonly maxIdleTime: Duration.Duration;\n\n  /**\n   * Maximum number of processed transaction IDs to track for deduplication.\n   * @default 1000\n   */\n  readonly maxTransactionHistory: number;\n\n  /**\n   * Heartbeat interval for WebSocket connections.\n   * @default \"30 seconds\"\n   */\n  readonly heartbeatInterval: Duration.Duration;\n\n  /**\n   * Timeout for heartbeat responses before considering connection dead.\n   * @default \"10 seconds\"\n   */\n  readonly heartbeatTimeout: Duration.Duration;\n\n  /**\n   * Optional presence schema for ephemeral per-user data.\n   * When provided, enables presence features on WebSocket connections.\n   * @default undefined (presence disabled)\n   */\n  readonly presence: Presence.AnyPresence | undefined;\n}\n\n/**\n * Options for creating a MimicServerConfig.\n */\nexport interface MimicServerConfigOptions<TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive> {\n  /**\n   * The schema defining the document structure.\n   */\n  readonly schema: TSchema;\n\n  /**\n   * Maximum idle time for a document before it is cleaned up.\n   * @default \"5 minutes\"\n   */\n  readonly maxIdleTime?: DurationInput;\n\n  /**\n   * Maximum number of processed transaction IDs to track for deduplication.\n   * @default 1000\n   */\n  readonly maxTransactionHistory?: number;\n\n  /**\n   * Heartbeat interval for WebSocket connections.\n   * @default \"30 seconds\"\n   */\n  readonly heartbeatInterval?: DurationInput;\n\n  /**\n   * Timeout for heartbeat responses.\n   * @default \"10 seconds\"\n   */\n  readonly heartbeatTimeout?: DurationInput;\n\n  /**\n   * Optional presence schema for ephemeral per-user data.\n   * When provided, enables presence features on WebSocket connections.\n   * @default undefined (presence disabled)\n   */\n  readonly presence?: Presence.AnyPresence;\n}\n\n/**\n * Create a MimicServerConfig from options.\n */\nexport const make = <TSchema extends Primitive.AnyPrimitive>(\n  options: MimicServerConfigOptions<TSchema>\n): MimicServerConfig<TSchema> => ({\n  schema: options.schema,\n  maxIdleTime: Duration.decode(options.maxIdleTime ?? \"5 minutes\"),\n  maxTransactionHistory: options.maxTransactionHistory ?? 1000,\n  heartbeatInterval: Duration.decode(options.heartbeatInterval ?? \"30 seconds\"),\n  heartbeatTimeout: Duration.decode(options.heartbeatTimeout ?? \"10 seconds\"),\n  presence: options.presence,\n});\n\n// =============================================================================\n// Context Tag\n// =============================================================================\n\n/**\n * Context tag for MimicServerConfig.\n */\nexport class MimicServerConfigTag extends Context.Tag(\n  \"@voidhash/mimic-server-effect/MimicServerConfig\"\n)<MimicServerConfigTag, MimicServerConfig>() {}\n\n/**\n * Create a Layer that provides MimicServerConfig.\n */\nexport const layer = <TSchema extends Primitive.AnyPrimitive>(\n  options: MimicServerConfigOptions<TSchema>\n): Layer.Layer<MimicServerConfigTag> =>\n  Layer.succeed(MimicServerConfigTag, make(options));\n"],"mappings":";;;;;;;;;;;;;;;;;;AAsGA,MAAa,QACX,YAC+B;;QAAC;EAChC,QAAQ,QAAQ;EAChB,aAAa,SAAS,+BAAO,QAAQ,kFAAe,YAAY;EAChE,gDAAuB,QAAQ,8FAAyB;EACxD,mBAAmB,SAAS,gCAAO,QAAQ,0FAAqB,aAAa;EAC7E,kBAAkB,SAAS,gCAAO,QAAQ,yFAAoB,aAAa;EAC3E,UAAU,QAAQ;EACnB;;;;;AASD,IAAa,uBAAb,cAA0C,QAAQ,IAChD,kDACD,EAA2C,CAAC;;;;AAK7C,MAAa,SACX,YAEA,MAAM,QAAQ,sBAAsB,KAAK,QAAQ,CAAC"}
+{"version":3,"file":"MimicConfig.mjs","names":["initialFn: InitialFn<TSchema> | undefined"],"sources":["../src/MimicConfig.ts"],"sourcesContent":["/**\n * @since 0.0.1\n * Configuration types for the Mimic server.\n */\nimport * as Context from \"effect/Context\";\nimport * as Duration from \"effect/Duration\";\nimport type { DurationInput } from \"effect/Duration\";\nimport * as Effect from \"effect/Effect\";\nimport * as Layer from \"effect/Layer\";\nimport { Primitive, Presence } from \"@voidhash/mimic\";\n\n// =============================================================================\n// Initial State Types\n// =============================================================================\n\n/**\n * Context available when computing initial state for a document.\n */\nexport interface InitialContext {\n  /**\n   * The document ID being initialized.\n   */\n  readonly documentId: string;\n}\n\n/**\n * Function that computes initial state for a document.\n * Receives context with the document ID and returns an Effect that produces the initial state.\n */\nexport type InitialFn<TSchema extends Primitive.AnyPrimitive> = (\n  context: InitialContext\n) => Effect.Effect<Primitive.InferSetInput<TSchema>>;\n\n// =============================================================================\n// Mimic Server Configuration\n// =============================================================================\n\n/**\n * Configuration for the Mimic server.\n * \n * Note: Authentication and persistence are now handled by injectable services\n * (MimicAuthService and MimicDataStorage) rather than config options.\n */\nexport interface MimicServerConfig<\n  TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive,\n> {\n  /**\n   * The schema defining the document structure.\n   */\n  readonly schema: TSchema;\n\n  /**\n   * Maximum idle time for a document before it is cleaned up.\n   * @default \"5 minutes\"\n   */\n  readonly maxIdleTime: Duration.Duration;\n\n  /**\n   * Maximum number of processed transaction IDs to track for deduplication.\n   * @default 1000\n   */\n  readonly maxTransactionHistory: number;\n\n  /**\n   * Heartbeat interval for WebSocket connections.\n   * @default \"30 seconds\"\n   */\n  readonly heartbeatInterval: Duration.Duration;\n\n  /**\n   * Timeout for heartbeat responses before considering connection dead.\n   * @default \"10 seconds\"\n   */\n  readonly heartbeatTimeout: Duration.Duration;\n\n  /**\n   * Optional presence schema for ephemeral per-user data.\n   * When provided, enables presence features on WebSocket connections.\n   * @default undefined (presence disabled)\n   */\n  readonly presence: Presence.AnyPresence | undefined;\n\n  /**\n   * Initial state function for new documents.\n   * Called when a document is created and no existing state is found in storage.\n   * Receives the document ID and returns an Effect that produces the initial state.\n   * @default undefined (documents start empty or use schema defaults)\n   */\n  readonly initial: InitialFn<TSchema> | undefined;\n}\n\n/**\n * Options for creating a MimicServerConfig.\n */\nexport interface MimicServerConfigOptions<\n  TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive,\n> {\n  /**\n   * The schema defining the document structure.\n   */\n  readonly schema: TSchema;\n\n  /**\n   * Maximum idle time for a document before it is cleaned up.\n   * @default \"5 minutes\"\n   */\n  readonly maxIdleTime?: DurationInput;\n\n  /**\n   * Maximum number of processed transaction IDs to track for deduplication.\n   * @default 1000\n   */\n  readonly maxTransactionHistory?: number;\n\n  /**\n   * Heartbeat interval for WebSocket connections.\n   * @default \"30 seconds\"\n   */\n  readonly heartbeatInterval?: DurationInput;\n\n  /**\n   * Timeout for heartbeat responses.\n   * @default \"10 seconds\"\n   */\n  readonly heartbeatTimeout?: DurationInput;\n\n  /**\n   * Optional presence schema for ephemeral per-user data.\n   * When provided, enables presence features on WebSocket connections.\n   * @default undefined (presence disabled)\n   */\n  readonly presence?: Presence.AnyPresence;\n\n  /**\n   * Initial state for new documents.\n   * Can be either:\n   * - A plain object with the initial state values\n   * - A function that receives context (with documentId) and returns an Effect producing the initial state\n   *\n   * Type-safe: required fields (without defaults) must be provided,\n   * while optional fields and fields with defaults can be omitted.\n   *\n   * @example\n   * // Plain object\n   * initial: { title: \"New Document\", count: 0 }\n   *\n   * @example\n   * // Function returning Effect\n   * initial: ({ documentId }) => Effect.succeed({ title: `Doc ${documentId}`, count: 0 })\n   *\n   * @default undefined (documents start empty or use schema defaults)\n   */\n  readonly initial?: Primitive.InferSetInput<TSchema> | InitialFn<TSchema>;\n}\n\n/**\n * Check if a value is an InitialFn (function) rather than a plain object.\n */\nconst isInitialFn = <TSchema extends Primitive.AnyPrimitive>(\n  value: Primitive.InferSetInput<TSchema> | InitialFn<TSchema> | undefined\n): value is InitialFn<TSchema> => typeof value === \"function\";\n\n/**\n * Create a MimicServerConfig from options.\n */\nexport const make = <TSchema extends Primitive.AnyPrimitive>(\n  options: MimicServerConfigOptions<TSchema>\n): MimicServerConfig<TSchema> => {\n  const { initial, schema } = options;\n\n  // Convert initial to a function that applies defaults\n  const initialFn: InitialFn<TSchema> | undefined = initial === undefined\n    ? undefined\n    : isInitialFn<TSchema>(initial)\n      ? (context) => Effect.map(\n          initial(context),\n          (state) => Primitive.applyDefaults(schema, state as Partial<Primitive.InferState<TSchema>>)\n        ) as Effect.Effect<Primitive.InferSetInput<TSchema>>\n      : () => Effect.succeed(\n          Primitive.applyDefaults(schema, initial as Partial<Primitive.InferState<TSchema>>)\n        ) as Effect.Effect<Primitive.InferSetInput<TSchema>>;\n\n  return {\n    schema,\n    maxIdleTime: Duration.decode(options.maxIdleTime ?? \"5 minutes\"),\n    maxTransactionHistory: options.maxTransactionHistory ?? 1000,\n    heartbeatInterval: Duration.decode(options.heartbeatInterval ?? \"30 seconds\"),\n    heartbeatTimeout: Duration.decode(options.heartbeatTimeout ?? \"10 seconds\"),\n    presence: options.presence,\n    initial: initialFn,\n  };\n};\n\n// =============================================================================\n// Context Tag\n// =============================================================================\n\n/**\n * Context tag for MimicServerConfig.\n */\nexport class MimicServerConfigTag extends Context.Tag(\n  \"@voidhash/mimic-server-effect/MimicServerConfig\"\n)<MimicServerConfigTag, MimicServerConfig>() {}\n\n/**\n * Create a Layer that provides MimicServerConfig.\n */\nexport const layer = <TSchema extends Primitive.AnyPrimitive>(\n  options: MimicServerConfigOptions<TSchema>\n): Layer.Layer<MimicServerConfigTag> =>\n  Layer.succeed(MimicServerConfigTag, make(options) as unknown as MimicServerConfig);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AA8JA,MAAM,eACJ,UACgC,OAAO,UAAU;;;;AAKnD,MAAa,QACX,YAC+B;;CAC/B,MAAM,EAAE,SAAS,WAAW;CAG5B,MAAMA,YAA4C,YAAY,SAC1D,SACA,YAAqB,QAAQ,IAC1B,YAAY,OAAO,IAClB,QAAQ,QAAQ,GACf,UAAU,UAAU,cAAc,QAAQ,MAAgD,CAC5F,SACK,OAAO,QACX,UAAU,cAAc,QAAQ,QAAkD,CACnF;AAEP,QAAO;EACL;EACA,aAAa,SAAS,+BAAO,QAAQ,kFAAe,YAAY;EAChE,gDAAuB,QAAQ,8FAAyB;EACxD,mBAAmB,SAAS,gCAAO,QAAQ,0FAAqB,aAAa;EAC7E,kBAAkB,SAAS,gCAAO,QAAQ,yFAAoB,aAAa;EAC3E,UAAU,QAAQ;EAClB,SAAS;EACV;;;;;AAUH,IAAa,uBAAb,cAA0C,QAAQ,IAChD,kDACD,EAA2C,CAAC;;;;AAK7C,MAAa,SACX,YAEA,MAAM,QAAQ,sBAAsB,KAAK,QAAQ,CAAiC"}

package/dist/MimicDataStorage.d.cts

@@ -1,14 +1,14 @@
 import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
 import * as Context from "effect/Context";
-import * as effect_Types6 from "effect/Types";
-import * as effect_Cause6 from "effect/Cause";
+import * as effect_Types0 from "effect/Types";
+import * as effect_Cause0 from "effect/Cause";
 
 //#region src/MimicDataStorage.d.ts
 declare namespace MimicDataStorage_d_exports {
   export { MimicDataStorage, MimicDataStorageTag, StorageDeleteError, StorageError, StorageLoadError, StorageSaveError, layer, layerEffect, make };
 }
-declare const StorageLoadError_base: new <A extends Record<string, any> = {}>(args: effect_Types6.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause6.YieldableError & {
+declare const StorageLoadError_base: new <A extends Record<string, any> = {}>(args: effect_Types0.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause0.YieldableError & {
   readonly _tag: "StorageLoadError";
 } & Readonly<A>;
 /**
@@ -20,7 +20,7 @@ declare class StorageLoadError extends StorageLoadError_base<{
 }> {
   get message(): string;
 }
-declare const StorageSaveError_base: new <A extends Record<string, any> = {}>(args: effect_Types6.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause6.YieldableError & {
+declare const StorageSaveError_base: new <A extends Record<string, any> = {}>(args: effect_Types0.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause0.YieldableError & {
   readonly _tag: "StorageSaveError";
 } & Readonly<A>;
 /**
@@ -32,7 +32,7 @@ declare class StorageSaveError extends StorageSaveError_base<{
 }> {
   get message(): string;
 }
-declare const StorageDeleteError_base: new <A extends Record<string, any> = {}>(args: effect_Types6.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause6.YieldableError & {
+declare const StorageDeleteError_base: new <A extends Record<string, any> = {}>(args: effect_Types0.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause0.YieldableError & {
   readonly _tag: "StorageDeleteError";
 } & Readonly<A>;
 /**