@voidhash/mimic-effect 0.0.3 → 0.0.5

package/dist/MimicServer.mjs

@@ -1,15 +1,13 @@
 import { __export } from "./_virtual/rolldown_runtime.mjs";
-import { MimicServerConfigTag, layer as layer$1 } from "./MimicConfig.mjs";
-import { DocumentManagerTag, layer as layer$2 } from "./DocumentManager.mjs";
+import { MimicServerConfigTag, layer } from "./MimicConfig.mjs";
+import { DocumentManagerTag, layer as layer$1 } from "./DocumentManager.mjs";
 import { MimicAuthServiceTag } from "./MimicAuthService.mjs";
-import { PresenceManagerTag, layer as layer$3 } from "./PresenceManager.mjs";
-import { extractDocumentId, handleConnection, makeHandler } from "./WebSocketHandler.mjs";
+import { PresenceManagerTag, layer as layer$2 } from "./PresenceManager.mjs";
+import { extractDocumentId, handleConnection } from "./WebSocketHandler.mjs";
 import { layerDefault } from "./storage/InMemoryDataStorage.mjs";
 import { layerDefault as layerDefault$1 } from "./auth/NoAuth.mjs";
 import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
-import * as Context from "effect/Context";
-import { SocketServer } from "@effect/platform/SocketServer";
 import { HttpLayerRouter, HttpServerRequest, HttpServerResponse } from "@effect/platform";
 
 //#region src/MimicServer.ts
@@ -18,119 +16,13 @@ import { HttpLayerRouter, HttpServerRequest, HttpServerResponse } from "@effect/
 * Mimic server layer composition.
 */
 var MimicServer_exports = /* @__PURE__ */ __export({
-	MimicWebSocketHandler: () => MimicWebSocketHandler,
 	documentManagerLayer: () => documentManagerLayer,
-	handlerLayer: () => handlerLayer,
-	layer: () => layer,
-	layerHttpLayerRouter: () => layerHttpLayerRouter,
-	run: () => run
+	layerHttpLayerRouter: () => layerHttpLayerRouter
 });
 /**
-* Tag for the WebSocket handler function.
-*/
-var MimicWebSocketHandler = class extends Context.Tag("@voidhash/mimic-server-effect/MimicWebSocketHandler")() {};
-/**
-* Create a Mimic WebSocket handler layer.
-* 
-* This layer provides a handler function that can be used with any WebSocket server
-* implementation. The handler takes a socket and document ID and manages the
-* document synchronization.
-* 
-* By default, uses in-memory storage and no authentication.
-* Override these by providing MimicDataStorage and MimicAuthService layers.
-* 
-* @example
-* ```typescript
-* import { MimicServer, MimicAuthService } from "@voidhash/mimic-effect";
-* import { Primitive } from "@voidhash/mimic";
-* 
-* const TodoSchema = Primitive.Struct({
-*   title: Primitive.String(),
-*   completed: Primitive.Boolean(),
-* });
-* 
-* // Create the handler layer with defaults
-* const HandlerLayer = MimicServer.layer({
-*   basePath: "/mimic/todo",
-*   schema: TodoSchema
-* });
-* 
-* // Or with custom auth
-* const HandlerLayerWithAuth = MimicServer.layer({
-*   basePath: "/mimic/todo",
-*   schema: TodoSchema
-* }).pipe(
-*   Layer.provideMerge(MimicAuthService.layer({
-*     authHandler: (token) => ({ success: true, userId: "user-123" })
-*   }))
-* );
-* ```
-*/
-const layer = (options) => {
-	const configLayer = layer$1({
-		schema: options.schema,
-		maxTransactionHistory: options.maxTransactionHistory,
-		presence: options.presence
-	});
-	return Layer.merge(Layer.effect(MimicWebSocketHandler, makeHandler).pipe(Layer.provide(layer$2), Layer.provide(layer$3), Layer.provide(configLayer)), layer$2.pipe(Layer.provide(configLayer))).pipe(Layer.provide(layerDefault), Layer.provide(layerDefault$1));
-};
-/**
-* Create the Mimic server handler layer.
-* This layer provides the WebSocket handler that can be used with any WebSocket server.
-*
-* @example
-* ```typescript
-* import { MimicServer } from "@voidhash/mimic-server-effect";
-* import { SocketServer } from "@effect/platform/SocketServer";
-* import { Primitive } from "@voidhash/mimic";
-*
-* // Define your document schema
-* const TodoSchema = Primitive.Struct({
-*   title: Primitive.String(),
-*   completed: Primitive.Boolean(),
-* });
-*
-* // Create the server layer
-* const serverLayer = MimicServer.handlerLayer({
-*   schema: TodoSchema,
-* });
-*
-* // Run with your socket server
-* Effect.gen(function* () {
-*   const handler = yield* MimicServer.MimicWebSocketHandler;
-*   const server = yield* SocketServer;
-*
-*   yield* server.run((socket) =>
-*     // Extract document ID from request and call handler
-*     handler(socket, "my-document-id")
-*   );
-* }).pipe(
-*   Effect.provide(serverLayer),
-*   Effect.provide(YourSocketServerLayer),
-* );
-* ```
-*/
-const handlerLayer = (options) => Layer.effect(MimicWebSocketHandler, makeHandler).pipe(Layer.provide(layer$2), Layer.provide(layer$3), Layer.provide(layer$1(options)), Layer.provide(layerDefault), Layer.provide(layerDefault$1));
-/**
 * Create the document manager layer.
 */
-const documentManagerLayer = (options) => layer$2.pipe(Layer.provide(layer$1(options)), Layer.provide(layerDefault), Layer.provide(layerDefault$1));
-/**
-* Run a Mimic WebSocket server with the provided handler.
-*
-* This is a helper that:
-* 1. Gets the WebSocket handler from context
-* 2. Runs the socket server with the handler
-*
-* Note: The document ID extraction from socket is implementation-specific.
-* You may need to customize this based on your socket server.
-*/
-const run = (extractDocumentId$1) => Effect.gen(function* () {
-	const handler = yield* MimicWebSocketHandler;
-	yield* (yield* SocketServer).run((socket) => Effect.gen(function* () {
-		yield* handler(socket, yield* extractDocumentId$1(socket));
-	}).pipe(Effect.catchAll((error) => Effect.logError("Connection error", error))));
-});
+const documentManagerLayer = (options) => layer$1.pipe(Layer.provide(layer(options)), Layer.provide(layerDefault), Layer.provide(layerDefault$1));
 /**
 * Create the HTTP handler effect for WebSocket upgrade.
 * This handler:
@@ -200,22 +92,26 @@ const makeMimicHandler = Effect.gen(function* () {
 * );
 * ```
 */
-const layerHttpLayerRouter = (options) => {
-	var _options$basePath, _options$authLayer, _options$storageLayer;
-	const wsPath = `${(_options$basePath = options.basePath) !== null && _options$basePath !== void 0 ? _options$basePath : "/mimic"}/doc/*`;
-	const configLayer = layer$1({
-		schema: options.schema,
-		maxTransactionHistory: options.maxTransactionHistory,
-		presence: options.presence
-	});
-	const authLayer = (_options$authLayer = options.authLayer) !== null && _options$authLayer !== void 0 ? _options$authLayer : layerDefault$1;
-	const storageLayer = (_options$storageLayer = options.storageLayer) !== null && _options$storageLayer !== void 0 ? _options$storageLayer : layerDefault;
-	const registerRoute = Effect.gen(function* () {
-		const router = yield* HttpLayerRouter.HttpRouter;
-		const handler = yield* makeMimicHandler;
-		yield* router.add("GET", wsPath, handler);
-	});
-	return Layer.scopedDiscard(registerRoute).pipe(Layer.provide(layer$2), Layer.provide(layer$3), Layer.provide(configLayer), Layer.provide(storageLayer), Layer.provide(authLayer));
+const layerHttpLayerRouter = (optionsEf) => {
+	return Layer.unwrapScoped(Effect.gen(function* () {
+		var _options$basePath, _options$authLayer, _options$storageLayer;
+		const options = yield* optionsEf;
+		const wsPath = `${(_options$basePath = options.basePath) !== null && _options$basePath !== void 0 ? _options$basePath : "/mimic"}/doc/*`;
+		const configLayer = layer({
+			schema: options.schema,
+			maxTransactionHistory: options.maxTransactionHistory,
+			presence: options.presence,
+			initial: options.initial
+		});
+		const authLayer = (_options$authLayer = options.authLayer) !== null && _options$authLayer !== void 0 ? _options$authLayer : layerDefault$1;
+		const storageLayer = (_options$storageLayer = options.storageLayer) !== null && _options$storageLayer !== void 0 ? _options$storageLayer : layerDefault;
+		const depsLayer = Layer.mergeAll(configLayer, authLayer, storageLayer);
+		return Layer.scopedDiscard(Effect.gen(function* () {
+			const router = yield* HttpLayerRouter.HttpRouter;
+			const handler = yield* makeMimicHandler;
+			yield* router.add("GET", wsPath, handler);
+		})).pipe(Layer.provide(layer$1), Layer.provide(layer$2), Layer.provide(depsLayer));
+	}));
 };
 
 //#endregion

package/dist/MimicServer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"MimicServer.mjs","names":["MimicConfig.layer","WebSocketHandler.makeHandler","DocumentManager.layer","PresenceManager.layer","InMemoryDataStorage.layerDefault","NoAuth.layerDefault","extractDocumentId","MimicConfig.MimicServerConfigTag","DocumentManager.DocumentManagerTag","PresenceManager.PresenceManagerTag","WebSocketHandler.extractDocumentId","WebSocketHandler.handleConnection","wsPath: PathInput"],"sources":["../src/MimicServer.ts"],"sourcesContent":["/**\n * @since 0.0.1\n * Mimic server layer composition.\n */\nimport * as Effect from \"effect/Effect\";\nimport * as Layer from \"effect/Layer\";\nimport * as Context from \"effect/Context\";\nimport type * as Socket from \"@effect/platform/Socket\";\nimport { SocketServer } from \"@effect/platform/SocketServer\";\nimport type { Primitive, Presence } from \"@voidhash/mimic\";\n\nimport * as DocumentManager from \"./DocumentManager.js\";\nimport * as WebSocketHandler from \"./WebSocketHandler.js\";\nimport * as MimicConfig from \"./MimicConfig.js\";\nimport { MimicDataStorageTag } from \"./MimicDataStorage.js\";\nimport { MimicAuthServiceTag } from \"./MimicAuthService.js\";\nimport * as PresenceManager from \"./PresenceManager.js\";\nimport * as InMemoryDataStorage from \"./storage/InMemoryDataStorage.js\";\nimport * as NoAuth from \"./auth/NoAuth.js\";\nimport { HttpLayerRouter, HttpServerRequest, HttpServerResponse } from \"@effect/platform\";\nimport { PathInput } from \"@effect/platform/HttpRouter\";\n\n// =============================================================================\n// Handler Tag\n// =============================================================================\n\n/**\n * Tag for the WebSocket handler function.\n */\nexport class MimicWebSocketHandler extends Context.Tag(\n  \"@voidhash/mimic-server-effect/MimicWebSocketHandler\"\n)<\n  MimicWebSocketHandler,\n  (socket: Socket.Socket, documentId: string) => Effect.Effect<void, unknown>\n>() {}\n\n// =============================================================================\n// Layer Composition Options\n// =============================================================================\n\n/**\n * Options for creating a Mimic server layer.\n */\nexport interface MimicLayerOptions<TSchema extends Primitive.AnyPrimitive> {\n  /**\n   * Base path for document routes (used for path matching).\n   * @example \"/mimic/todo\" - documents accessed at \"/mimic/todo/:documentId\"\n   */\n  readonly basePath?: PathInput;\n  /**\n   * The schema defining the document structure.\n   */\n  readonly schema: TSchema;\n  /**\n   * Maximum number of processed transaction IDs to track for deduplication.\n   * @default 1000\n   */\n  readonly maxTransactionHistory?: number;\n  /**\n   * Optional presence schema for ephemeral per-user data.\n   * When provided, enables presence features on WebSocket connections.\n   */\n  readonly presence?: Presence.AnyPresence;\n}\n\n// =============================================================================\n// Layer Composition\n// =============================================================================\n\n/**\n * Create a Mimic WebSocket handler layer.\n * \n * This layer provides a handler function that can be used with any WebSocket server\n * implementation. The handler takes a socket and document ID and manages the\n * document synchronization.\n * \n * By default, uses in-memory storage and no authentication.\n * Override these by providing MimicDataStorage and MimicAuthService layers.\n * \n * @example\n * ```typescript\n * import { MimicServer, MimicAuthService } from \"@voidhash/mimic-effect\";\n * import { Primitive } from \"@voidhash/mimic\";\n * \n * const TodoSchema = Primitive.Struct({\n *   title: Primitive.String(),\n *   completed: Primitive.Boolean(),\n * });\n * \n * // Create the handler layer with defaults\n * const HandlerLayer = MimicServer.layer({\n *   basePath: \"/mimic/todo\",\n *   schema: TodoSchema\n * });\n * \n * // Or with custom auth\n * const HandlerLayerWithAuth = MimicServer.layer({\n *   basePath: \"/mimic/todo\",\n *   schema: TodoSchema\n * }).pipe(\n *   Layer.provideMerge(MimicAuthService.layer({\n *     authHandler: (token) => ({ success: true, userId: \"user-123\" })\n *   }))\n * );\n * ```\n */\nexport const layer = <TSchema extends Primitive.AnyPrimitive>(\n  options: MimicLayerOptions<TSchema>\n): Layer.Layer<MimicWebSocketHandler | DocumentManager.DocumentManagerTag> => {\n  const configLayer = MimicConfig.layer({\n    schema: options.schema,\n    maxTransactionHistory: options.maxTransactionHistory,\n    presence: options.presence,\n  });\n\n  return Layer.merge(\n    // Handler layer\n    Layer.effect(MimicWebSocketHandler, WebSocketHandler.makeHandler).pipe(\n      Layer.provide(DocumentManager.layer),\n      Layer.provide(PresenceManager.layer),\n      Layer.provide(configLayer)\n    ),\n    // Document manager layer\n    DocumentManager.layer.pipe(Layer.provide(configLayer))\n  ).pipe(\n    // Provide defaults if not overridden\n    Layer.provide(InMemoryDataStorage.layerDefault),\n    Layer.provide(NoAuth.layerDefault)\n  );\n};\n\n/**\n * Create the Mimic server handler layer.\n * This layer provides the WebSocket handler that can be used with any WebSocket server.\n *\n * @example\n * ```typescript\n * import { MimicServer } from \"@voidhash/mimic-server-effect\";\n * import { SocketServer } from \"@effect/platform/SocketServer\";\n * import { Primitive } from \"@voidhash/mimic\";\n *\n * // Define your document schema\n * const TodoSchema = Primitive.Struct({\n *   title: Primitive.String(),\n *   completed: Primitive.Boolean(),\n * });\n *\n * // Create the server layer\n * const serverLayer = MimicServer.handlerLayer({\n *   schema: TodoSchema,\n * });\n *\n * // Run with your socket server\n * Effect.gen(function* () {\n *   const handler = yield* MimicServer.MimicWebSocketHandler;\n *   const server = yield* SocketServer;\n *\n *   yield* server.run((socket) =>\n *     // Extract document ID from request and call handler\n *     handler(socket, \"my-document-id\")\n *   );\n * }).pipe(\n *   Effect.provide(serverLayer),\n *   Effect.provide(YourSocketServerLayer),\n * );\n * ```\n */\nexport const handlerLayer = <TSchema extends Primitive.AnyPrimitive>(\n  options: MimicConfig.MimicServerConfigOptions<TSchema>\n): Layer.Layer<MimicWebSocketHandler> =>\n  Layer.effect(MimicWebSocketHandler, WebSocketHandler.makeHandler).pipe(\n    Layer.provide(DocumentManager.layer),\n    Layer.provide(PresenceManager.layer),\n    Layer.provide(MimicConfig.layer(options)),\n    // Provide defaults\n    Layer.provide(InMemoryDataStorage.layerDefault),\n    Layer.provide(NoAuth.layerDefault)\n  );\n\n/**\n * Create the document manager layer.\n */\nexport const documentManagerLayer = <TSchema extends Primitive.AnyPrimitive>(\n  options: MimicConfig.MimicServerConfigOptions<TSchema>\n): Layer.Layer<DocumentManager.DocumentManagerTag> =>\n  DocumentManager.layer.pipe(\n    Layer.provide(MimicConfig.layer(options)),\n    // Provide defaults\n    Layer.provide(InMemoryDataStorage.layerDefault),\n    Layer.provide(NoAuth.layerDefault)\n  );\n\n// =============================================================================\n// Convenience Functions\n// =============================================================================\n\n/**\n * Run a Mimic WebSocket server with the provided handler.\n *\n * This is a helper that:\n * 1. Gets the WebSocket handler from context\n * 2. Runs the socket server with the handler\n *\n * Note: The document ID extraction from socket is implementation-specific.\n * You may need to customize this based on your socket server.\n */\nexport const run = (\n  extractDocumentId: (socket: Socket.Socket) => Effect.Effect<string>\n) =>\n  Effect.gen(function* () {\n    const handler = yield* MimicWebSocketHandler;\n    const server = yield* SocketServer;\n\n    yield* server.run((socket) =>\n      Effect.gen(function* () {\n        const documentId = yield* extractDocumentId(socket);\n        yield* handler(socket, documentId);\n      }).pipe(\n        Effect.catchAll((error) =>\n          Effect.logError(\"Connection error\", error)\n        )\n      )\n    );\n  });\n\n\n/**\n * Create the HTTP handler effect for WebSocket upgrade.\n * This handler:\n * 1. Extracts the document ID from the URL path\n * 2. Upgrades the HTTP connection to WebSocket\n * 3. Delegates to the WebSocketHandler for document sync\n */\nconst makeMimicHandler = Effect.gen(function* () {\n  const config = yield* MimicConfig.MimicServerConfigTag;\n  const authService = yield* MimicAuthServiceTag;\n  const documentManager = yield* DocumentManager.DocumentManagerTag;\n  const presenceManager = yield* PresenceManager.PresenceManagerTag;\n\n  return Effect.gen(function* () {\n    const request = yield* HttpServerRequest.HttpServerRequest;\n\n    // Extract document ID from the URL path\n    // Expected format: /basePath/doc/{documentId}\n    const documentId = yield* WebSocketHandler.extractDocumentId(request.url);\n\n    // Upgrade to WebSocket\n    const socket = yield* request.upgrade;\n\n    // Handle the WebSocket connection\n    yield* WebSocketHandler.handleConnection(socket, request.url).pipe(\n      Effect.provideService(MimicConfig.MimicServerConfigTag, config),\n      Effect.provideService(MimicAuthServiceTag, authService),\n      Effect.provideService(DocumentManager.DocumentManagerTag, documentManager),\n      Effect.provideService(PresenceManager.PresenceManagerTag, presenceManager),\n      Effect.scoped,\n      Effect.catchAll((error) =>\n        Effect.logError(\"WebSocket connection error\", error)\n      )\n    );\n\n    // Return empty response - the WebSocket upgrade handles the connection\n    return HttpServerResponse.empty();\n  }).pipe(\n    Effect.catchAll((error) =>\n      Effect.gen(function* () {\n        yield* Effect.logWarning(\"WebSocket upgrade failed\", error);\n        return HttpServerResponse.text(\"WebSocket upgrade failed\", {\n          status: 400,\n        });\n      })\n    )\n  );\n});\n\n\n\n/**\n * Create a Mimic server layer that integrates with HttpLayerRouter.\n *\n * This function creates a layer that:\n * 1. Registers a WebSocket route at the specified base path\n * 2. Handles WebSocket upgrades for document sync\n * 3. Provides all required dependencies (config, auth, storage, document manager)\n *\n * By default, uses in-memory storage and no authentication.\n * To override these defaults, provide custom layers before the defaults:\n *\n * @example\n * ```typescript\n * import { MimicServer, MimicAuthService } from \"@voidhash/mimic-effect\";\n * import { HttpLayerRouter } from \"@effect/platform\";\n * import { Primitive } from \"@voidhash/mimic\";\n *\n * const TodoSchema = Primitive.Struct({\n *   title: Primitive.String(),\n *   completed: Primitive.Boolean(),\n * });\n *\n * // Create the Mimic route layer with defaults\n * const MimicRoute = MimicServer.layerHttpLayerRouter({\n *   basePath: \"/mimic/todo\",\n *   schema: TodoSchema\n * });\n *\n * // Or with custom auth - use Layer.provide to inject before defaults\n * const MimicRouteWithAuth = MimicServer.layerHttpLayerRouter({\n *   basePath: \"/mimic/todo\",\n *   schema: TodoSchema,\n *   authLayer: MimicAuthService.layer({\n *     authHandler: (token) => ({ success: true, userId: token })\n *   })\n * });\n *\n * // Merge with other routes and serve\n * const AllRoutes = Layer.mergeAll(MimicRoute, OtherRoutes);\n * HttpLayerRouter.serve(AllRoutes).pipe(\n *   Layer.provide(BunHttpServer.layer({ port: 3000 })),\n *   Layer.launch,\n *   BunRuntime.runMain\n * );\n * ```\n */\nexport const layerHttpLayerRouter = <TSchema extends Primitive.AnyPrimitive>(\n  options: MimicLayerOptions<TSchema> & {\n    /** Custom auth layer. Defaults to NoAuth (all connections allowed). */\n    readonly authLayer?: Layer.Layer<MimicAuthServiceTag>;\n    /** Custom storage layer. Defaults to InMemoryDataStorage. */\n    readonly storageLayer?: Layer.Layer<MimicDataStorageTag>;\n  }\n) => {\n  // Build the base path pattern for WebSocket routes\n  // Append /doc/* to match /basePath/doc/{documentId}\n  const basePath = options.basePath ?? \"/mimic\";\n  const wsPath: PathInput = `${basePath}/doc/*` as PathInput;\n\n  // Create the config layer\n  const configLayer = MimicConfig.layer({\n    schema: options.schema,\n    maxTransactionHistory: options.maxTransactionHistory,\n    presence: options.presence,\n  });\n\n  // Use provided layers or defaults\n  const authLayer = options.authLayer ?? NoAuth.layerDefault;\n  const storageLayer = options.storageLayer ?? InMemoryDataStorage.layerDefault;\n\n  // Create the route registration effect\n  const registerRoute = Effect.gen(function* () {\n    const router = yield* HttpLayerRouter.HttpRouter;\n    const handler = yield* makeMimicHandler;\n    yield* router.add(\"GET\", wsPath, handler);\n  });\n\n  // Build the layer with all dependencies\n  return Layer.scopedDiscard(registerRoute).pipe(\n    Layer.provide(DocumentManager.layer),\n    Layer.provide(PresenceManager.layer),\n    Layer.provide(configLayer),\n    Layer.provide(storageLayer),\n    Layer.provide(authLayer)\n  );\n};"],"mappings":"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"}
+{"version":3,"file":"MimicServer.mjs","names":["MimicConfig.layer","InMemoryDataStorage.layerDefault","NoAuth.layerDefault","MimicConfig.MimicServerConfigTag","DocumentManager.DocumentManagerTag","PresenceManager.PresenceManagerTag","WebSocketHandler.extractDocumentId","WebSocketHandler.handleConnection","wsPath: PathInput","DocumentManager.layer","PresenceManager.layer"],"sources":["../src/MimicServer.ts"],"sourcesContent":["/**\n * @since 0.0.1\n * Mimic server layer composition.\n */\nimport * as Effect from \"effect/Effect\";\nimport * as Layer from \"effect/Layer\";\nimport * as Context from \"effect/Context\";\nimport type * as Socket from \"@effect/platform/Socket\";\nimport { SocketServer } from \"@effect/platform/SocketServer\";\nimport type { Primitive, Presence } from \"@voidhash/mimic\";\n\nimport * as DocumentManager from \"./DocumentManager.js\";\nimport * as WebSocketHandler from \"./WebSocketHandler.js\";\nimport * as MimicConfig from \"./MimicConfig.js\";\nimport { MimicDataStorageTag } from \"./MimicDataStorage.js\";\nimport { MimicAuthServiceTag } from \"./MimicAuthService.js\";\nimport * as PresenceManager from \"./PresenceManager.js\";\nimport * as InMemoryDataStorage from \"./storage/InMemoryDataStorage.js\";\nimport * as NoAuth from \"./auth/NoAuth.js\";\nimport { HttpLayerRouter, HttpServerRequest, HttpServerResponse } from \"@effect/platform\";\nimport { PathInput } from \"@effect/platform/HttpRouter\";\n\n// =============================================================================\n// Layer Composition Options\n// =============================================================================\n\n/**\n * Options for creating a Mimic server layer.\n */\nexport interface MimicLayerOptions<\n  TSchema extends Primitive.AnyPrimitive,\n> {\n  /**\n   * Base path for document routes (used for path matching).\n   * @example \"/mimic/todo\" - documents accessed at \"/mimic/todo/:documentId\"\n   */\n  readonly basePath?: PathInput;\n  /**\n   * The schema defining the document structure.\n   */\n  readonly schema: TSchema;\n  /**\n   * Maximum number of processed transaction IDs to track for deduplication.\n   * @default 1000\n   */\n  readonly maxTransactionHistory?: number;\n  /**\n   * Optional presence schema for ephemeral per-user data.\n   * When provided, enables presence features on WebSocket connections.\n   */\n  readonly presence?: Presence.AnyPresence;\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   * When using a function that requires Effect services (has R requirements),\n   * you must also provide `initialLayer` to supply those dependencies.\n   *\n   * Type-safe: required fields (without defaults) must be provided,\n   * while optional fields and fields with defaults can be omitted.\n   *\n   * @default undefined (documents start empty or use schema defaults)\n   */\n  readonly initial?: Primitive.InferSetInput<TSchema> | MimicConfig.InitialFn<TSchema>;\n}\n\n\n/**\n * Create the document manager layer.\n */\nexport const documentManagerLayer = <TSchema extends Primitive.AnyPrimitive>(\n  options: MimicConfig.MimicServerConfigOptions<TSchema>\n): Layer.Layer<DocumentManager.DocumentManagerTag> =>\n  DocumentManager.layer.pipe(\n    Layer.provide(MimicConfig.layer(options)),\n    // Provide defaults\n    Layer.provide(InMemoryDataStorage.layerDefault),\n    Layer.provide(NoAuth.layerDefault)\n  );\n\n/**\n * Create the HTTP handler effect for WebSocket upgrade.\n * This handler:\n * 1. Extracts the document ID from the URL path\n * 2. Upgrades the HTTP connection to WebSocket\n * 3. Delegates to the WebSocketHandler for document sync\n */\nconst makeMimicHandler = Effect.gen(function* () {\n  const config = yield* MimicConfig.MimicServerConfigTag;\n  const authService = yield* MimicAuthServiceTag;\n  const documentManager = yield* DocumentManager.DocumentManagerTag;\n  const presenceManager = yield* PresenceManager.PresenceManagerTag;\n\n  return Effect.gen(function* () {\n    const request = yield* HttpServerRequest.HttpServerRequest;\n\n    // Extract document ID from the URL path\n    // Expected format: /basePath/doc/{documentId}\n    const documentId = yield* WebSocketHandler.extractDocumentId(request.url);\n\n    // Upgrade to WebSocket\n    const socket = yield* request.upgrade;\n\n    // Handle the WebSocket connection\n    yield* WebSocketHandler.handleConnection(socket, request.url).pipe(\n      Effect.provideService(MimicConfig.MimicServerConfigTag, config),\n      Effect.provideService(MimicAuthServiceTag, authService),\n      Effect.provideService(DocumentManager.DocumentManagerTag, documentManager),\n      Effect.provideService(PresenceManager.PresenceManagerTag, presenceManager),\n      Effect.scoped,\n      Effect.catchAll((error) =>\n        Effect.logError(\"WebSocket connection error\", error)\n      )\n    );\n\n    // Return empty response - the WebSocket upgrade handles the connection\n    return HttpServerResponse.empty();\n  }).pipe(\n    Effect.catchAll((error) =>\n      Effect.gen(function* () {\n        yield* Effect.logWarning(\"WebSocket upgrade failed\", error);\n        return HttpServerResponse.text(\"WebSocket upgrade failed\", {\n          status: 400,\n        });\n      })\n    )\n  );\n});\n\n\n\n/**\n * Options for layerHttpLayerRouter including optional custom layers.\n */\nexport interface MimicLayerRouterOptions<TSchema extends Primitive.AnyPrimitive>\n  extends MimicLayerOptions<TSchema> {\n  /** Custom auth layer. Defaults to NoAuth (all connections allowed). */\n  readonly authLayer?: Layer.Layer<MimicAuthServiceTag>;\n  /** Custom storage layer. Defaults to InMemoryDataStorage. */\n  readonly storageLayer?: Layer.Layer<MimicDataStorageTag>;\n}\n\n/**\n * Create a Mimic server layer that integrates with HttpLayerRouter.\n *\n * This function creates a layer that:\n * 1. Registers a WebSocket route at the specified base path\n * 2. Handles WebSocket upgrades for document sync\n * 3. Provides all required dependencies (config, auth, storage, document manager)\n *\n * By default, uses in-memory storage and no authentication.\n * To override these defaults, provide custom layers before the defaults:\n *\n * @example\n * ```typescript\n * import { MimicServer, MimicAuthService } from \"@voidhash/mimic-effect\";\n * import { HttpLayerRouter } from \"@effect/platform\";\n * import { Primitive } from \"@voidhash/mimic\";\n *\n * const TodoSchema = Primitive.Struct({\n *   title: Primitive.String(),\n *   completed: Primitive.Boolean(),\n * });\n *\n * // Create the Mimic route layer with defaults\n * const MimicRoute = MimicServer.layerHttpLayerRouter({\n *   basePath: \"/mimic/todo\",\n *   schema: TodoSchema\n * });\n *\n * // Or with custom auth - use Layer.provide to inject before defaults\n * const MimicRouteWithAuth = MimicServer.layerHttpLayerRouter({\n *   basePath: \"/mimic/todo\",\n *   schema: TodoSchema,\n *   authLayer: MimicAuthService.layer({\n *     authHandler: (token) => ({ success: true, userId: token })\n *   })\n * });\n *\n * // Merge with other routes and serve\n * const AllRoutes = Layer.mergeAll(MimicRoute, OtherRoutes);\n * HttpLayerRouter.serve(AllRoutes).pipe(\n *   Layer.provide(BunHttpServer.layer({ port: 3000 })),\n *   Layer.launch,\n *   BunRuntime.runMain\n * );\n * ```\n */\nexport const layerHttpLayerRouter = <\n  TSchema extends Primitive.AnyPrimitive,\n  TError,\n  TRequirements\n>(\n  optionsEf: Effect.Effect<MimicLayerRouterOptions<TSchema>, TError, TRequirements>\n): Layer.Layer<never, TError, TRequirements | HttpLayerRouter.HttpRouter> => {\n  return Layer.unwrapScoped(\n    Effect.gen(function* () {\n      const options = yield* optionsEf;\n\n      // Build the base path pattern for WebSocket routes\n      // Append /doc/* to match /basePath/doc/{documentId}\n      const basePath = options.basePath ?? \"/mimic\";\n      const wsPath: PathInput = `${basePath}/doc/*` as PathInput;\n\n      // Create the config layer with properly typed initial function\n      const configLayer = MimicConfig.layer<TSchema>({\n        schema: options.schema,\n        maxTransactionHistory: options.maxTransactionHistory,\n        presence: options.presence,\n        initial: options.initial,\n      });\n\n      // Use provided layers or defaults\n      const authLayer = options.authLayer ?? NoAuth.layerDefault;\n      const storageLayer = options.storageLayer ?? InMemoryDataStorage.layerDefault;\n\n      // Combine all dependency layers\n      const depsLayer = Layer.mergeAll(configLayer, authLayer, storageLayer);\n\n      // Create the route registration layer\n      const routeLayer = Layer.scopedDiscard(\n        Effect.gen(function* () {\n          const router = yield* HttpLayerRouter.HttpRouter;\n          const handler = yield* makeMimicHandler;\n          yield* router.add(\"GET\", wsPath, handler);\n        })\n      );\n\n      // Build the complete layer with all dependencies provided\n      return routeLayer.pipe(\n        Layer.provide(DocumentManager.layer),\n        Layer.provide(PresenceManager.layer),\n        Layer.provide(depsLayer),\n      );\n    })\n  );\n};"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAwEA,MAAa,wBACX,oBAEsB,KACpB,MAAM,QAAQA,MAAkB,QAAQ,CAAC,EAEzC,MAAM,QAAQC,aAAiC,EAC/C,MAAM,QAAQC,eAAoB,CACnC;;;;;;;;AASH,MAAM,mBAAmB,OAAO,IAAI,aAAa;CAC/C,MAAM,SAAS,OAAOC;CACtB,MAAM,cAAc,OAAO;CAC3B,MAAM,kBAAkB,OAAOC;CAC/B,MAAM,kBAAkB,OAAOC;AAE/B,QAAO,OAAO,IAAI,aAAa;EAC7B,MAAM,UAAU,OAAO,kBAAkB;AAItB,SAAOC,kBAAmC,QAAQ,IAAI;EAGzE,MAAM,SAAS,OAAO,QAAQ;AAG9B,SAAOC,iBAAkC,QAAQ,QAAQ,IAAI,CAAC,KAC5D,OAAO,eAAeJ,sBAAkC,OAAO,EAC/D,OAAO,eAAe,qBAAqB,YAAY,EACvD,OAAO,eAAeC,oBAAoC,gBAAgB,EAC1E,OAAO,eAAeC,oBAAoC,gBAAgB,EAC1E,OAAO,QACP,OAAO,UAAU,UACf,OAAO,SAAS,8BAA8B,MAAM,CACrD,CACF;AAGD,SAAO,mBAAmB,OAAO;GACjC,CAAC,KACD,OAAO,UAAU,UACf,OAAO,IAAI,aAAa;AACtB,SAAO,OAAO,WAAW,4BAA4B,MAAM;AAC3D,SAAO,mBAAmB,KAAK,4BAA4B,EACzD,QAAQ,KACT,CAAC;GACF,CACH,CACF;EACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6DF,MAAa,wBAKX,cAC2E;AAC3E,QAAO,MAAM,aACX,OAAO,IAAI,aAAa;;EACtB,MAAM,UAAU,OAAO;EAKvB,MAAMG,SAAoB,wBADT,QAAQ,yEAAY,SACC;EAGtC,MAAM,cAAcR,MAA2B;GAC7C,QAAQ,QAAQ;GAChB,uBAAuB,QAAQ;GAC/B,UAAU,QAAQ;GAClB,SAAS,QAAQ;GAClB,CAAC;EAGF,MAAM,kCAAY,QAAQ,4EAAaE;EACvC,MAAM,wCAAe,QAAQ,qFAAgBD;EAG7C,MAAM,YAAY,MAAM,SAAS,aAAa,WAAW,aAAa;AAYtE,SATmB,MAAM,cACvB,OAAO,IAAI,aAAa;GACtB,MAAM,SAAS,OAAO,gBAAgB;GACtC,MAAM,UAAU,OAAO;AACvB,UAAO,OAAO,IAAI,OAAO,QAAQ,QAAQ;IACzC,CACH,CAGiB,KAChB,MAAM,QAAQQ,QAAsB,EACpC,MAAM,QAAQC,QAAsB,EACpC,MAAM,QAAQ,UAAU,CACzB;GACD,CACH"}

package/dist/PresenceManager.cjs

@@ -3,14 +3,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);
 

package/dist/PresenceManager.mjs

@@ -1,10 +1,10 @@
 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 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";
 
 //#region src/PresenceManager.ts

package/dist/WebSocketHandler.cjs

@@ -11,9 +11,9 @@ let effect_Stream = require("effect/Stream");
 effect_Stream = require_rolldown_runtime.__toESM(effect_Stream);
 let effect_Duration = require("effect/Duration");
 effect_Duration = require_rolldown_runtime.__toESM(effect_Duration);
+let _voidhash_mimic = require("@voidhash/mimic");
 let effect_Fiber = require("effect/Fiber");
 effect_Fiber = require_rolldown_runtime.__toESM(effect_Fiber);
-let _voidhash_mimic = require("@voidhash/mimic");
 
 //#region src/WebSocketHandler.ts
 /**
@@ -362,5 +362,4 @@ Object.defineProperty(exports, 'WebSocketHandler_exports', {
   }
 });
 exports.extractDocumentId = extractDocumentId;
-exports.handleConnection = handleConnection;
-exports.makeHandler = makeHandler;
+exports.handleConnection = handleConnection;

package/dist/WebSocketHandler.d.cts

@@ -4,8 +4,8 @@ import { MimicAuthServiceTag } from "./MimicAuthService.cjs";
 import { PresenceManagerTag } from "./PresenceManager.cjs";
 import { MessageParseError, MissingDocumentIdError } from "./errors.cjs";
 import * as Effect from "effect/Effect";
-import * as Socket from "@effect/platform/Socket";
 import * as Scope from "effect/Scope";
+import * as Socket from "@effect/platform/Socket";
 
 //#region src/WebSocketHandler.d.ts
 declare namespace WebSocketHandler_d_exports {

package/dist/WebSocketHandler.d.mts

@@ -4,8 +4,8 @@ import { MimicAuthServiceTag } from "./MimicAuthService.mjs";
 import { PresenceManagerTag } from "./PresenceManager.mjs";
 import { MessageParseError, MissingDocumentIdError } from "./errors.mjs";
 import * as Effect from "effect/Effect";
-import * as Socket from "@effect/platform/Socket";
 import * as Scope from "effect/Scope";
+import * as Socket from "@effect/platform/Socket";
 
 //#region src/WebSocketHandler.d.ts
 declare namespace WebSocketHandler_d_exports {

package/dist/WebSocketHandler.mjs

@@ -8,8 +8,8 @@ import { _objectSpread2 } from "./_virtual/_@oxc-project_runtime@0.103.0/helpers
 import * as Effect from "effect/Effect";
 import * as Stream from "effect/Stream";
 import * as Duration from "effect/Duration";
-import * as Fiber from "effect/Fiber";
 import { Presence, Transaction } from "@voidhash/mimic";
+import * as Fiber from "effect/Fiber";
 
 //#region src/WebSocketHandler.ts
 /**
@@ -351,5 +351,5 @@ const handleConnectionWithDocumentId = (socket, documentId) => Effect.gen(functi
 });
 
 //#endregion
-export { WebSocketHandler_exports, extractDocumentId, handleConnection, makeHandler };
+export { WebSocketHandler_exports, extractDocumentId, handleConnection };
 //# sourceMappingURL=WebSocketHandler.mjs.map

package/dist/errors.d.cts

@@ -1,8 +1,8 @@
-import * as effect_Types0 from "effect/Types";
-import * as effect_Cause0 from "effect/Cause";
+import * as effect_Types2 from "effect/Types";
+import * as effect_Cause2 from "effect/Cause";
 
 //#region src/errors.d.ts
-declare const DocumentTypeNotFoundError_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 & {
+declare const DocumentTypeNotFoundError_base: new <A extends Record<string, any> = {}>(args: effect_Types2.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause2.YieldableError & {
   readonly _tag: "DocumentTypeNotFoundError";
 } & Readonly<A>;
 /**
@@ -13,7 +13,7 @@ declare class DocumentTypeNotFoundError extends DocumentTypeNotFoundError_base<{
 }> {
   get message(): string;
 }
-declare const DocumentNotFoundError_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 & {
+declare const DocumentNotFoundError_base: new <A extends Record<string, any> = {}>(args: effect_Types2.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause2.YieldableError & {
   readonly _tag: "DocumentNotFoundError";
 } & Readonly<A>;
 /**
@@ -24,7 +24,7 @@ declare class DocumentNotFoundError extends DocumentNotFoundError_base<{
 }> {
   get message(): string;
 }
-declare const AuthenticationError_base: new <A extends Record<string, any> = {}>(args: effect_Types0.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause0.YieldableError & {
+declare const AuthenticationError_base: new <A extends Record<string, any> = {}>(args: effect_Types2.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause2.YieldableError & {
   readonly _tag: "AuthenticationError";
 } & Readonly<A>;
 /**
@@ -35,7 +35,7 @@ declare class AuthenticationError extends AuthenticationError_base<{
 }> {
   get message(): string;
 }
-declare const TransactionRejectedError_base: new <A extends Record<string, any> = {}>(args: effect_Types0.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause0.YieldableError & {
+declare const TransactionRejectedError_base: new <A extends Record<string, any> = {}>(args: effect_Types2.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause2.YieldableError & {
   readonly _tag: "TransactionRejectedError";
 } & Readonly<A>;
 /**
@@ -47,7 +47,7 @@ declare class TransactionRejectedError extends TransactionRejectedError_base<{
 }> {
   get message(): string;
 }
-declare const MessageParseError_base: new <A extends Record<string, any> = {}>(args: effect_Types0.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause0.YieldableError & {
+declare const MessageParseError_base: new <A extends Record<string, any> = {}>(args: effect_Types2.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause2.YieldableError & {
   readonly _tag: "MessageParseError";
 } & Readonly<A>;
 /**
@@ -58,7 +58,7 @@ declare class MessageParseError extends MessageParseError_base<{
 }> {
   get message(): string;
 }
-declare const InvalidConnectionError_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 & {
+declare const InvalidConnectionError_base: new <A extends Record<string, any> = {}>(args: effect_Types2.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause2.YieldableError & {
   readonly _tag: "InvalidConnectionError";
 } & Readonly<A>;
 /**
@@ -69,7 +69,7 @@ declare class InvalidConnectionError extends InvalidConnectionError_base<{
 }> {
   get message(): string;
 }
-declare const MissingDocumentIdError_base: new <A extends Record<string, any> = {}>(args: effect_Types0.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause0.YieldableError & {
+declare const MissingDocumentIdError_base: new <A extends Record<string, any> = {}>(args: effect_Types2.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause2.YieldableError & {
   readonly _tag: "MissingDocumentIdError";
 } & Readonly<A>;
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voidhash/mimic-effect",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "type": "module",
   "repository": {
     "type": "git",
@@ -24,11 +24,11 @@
     "typescript": "5.8.3",
     "vite-tsconfig-paths": "^5.1.4",
     "vitest": "^3.2.4",
-    "@voidhash/tsconfig": "0.0.3"
+    "@voidhash/tsconfig": "0.0.5"
   },
   "peerDependencies": {
     "effect": "^3.19.12",
-    "@voidhash/mimic": "0.0.3"
+    "@voidhash/mimic": "0.0.5"
   },
   "scripts": {
     "build": "tsdown",

package/src/DocumentManager.ts

@@ -113,10 +113,12 @@ const makeDocumentManager = Effect.gen(function* () {
         () => Effect.succeed(undefined)
       );
 
-      // Transform loaded state with onLoad hook
+      // Transform loaded state with onLoad hook, or compute initial state for new docs
       const initialState = rawState !== undefined
         ? yield* storage.onLoad(rawState)
-        : undefined;
+        : config.initial !== undefined
+          ? yield* config.initial({ documentId })
+          : undefined;
 
       // Create PubSub for broadcasting
       const pubsub = yield* PubSub.unbounded<Protocol.ServerBroadcast>();
@@ -124,7 +126,7 @@ const makeDocumentManager = Effect.gen(function* () {
       // Create ServerDocument with broadcast callback
       const serverDocument = ServerDocument.make({
         schema: config.schema,
-        initialState: initialState as Primitive.InferState<typeof config.schema> | undefined,
+        initialState: initialState as Primitive.InferSetInput<typeof config.schema> | undefined,
         maxTransactionHistory: config.maxTransactionHistory,
         onBroadcast: (transactionMessage) => {
           // Get current state and save to storage

package/src/MimicConfig.ts

@@ -5,8 +5,31 @@
 import * as Context from "effect/Context";
 import * as Duration from "effect/Duration";
 import type { DurationInput } from "effect/Duration";
+import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
-import type { Primitive, Presence } from "@voidhash/mimic";
+import { Primitive, Presence } from "@voidhash/mimic";
+
+// =============================================================================
+// Initial State Types
+// =============================================================================
+
+/**
+ * Context available when computing initial state for a document.
+ */
+export 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.
+ */
+export type InitialFn<TSchema extends Primitive.AnyPrimitive> = (
+  context: InitialContext
+) => Effect.Effect<Primitive.InferSetInput<TSchema>>;
 
 // =============================================================================
 // Mimic Server Configuration
@@ -18,7 +41,9 @@ import type { Primitive, Presence } from "@voidhash/mimic";
  * Note: Authentication and persistence are now handled by injectable services
  * (MimicAuthService and MimicDataStorage) rather than config options.
  */
-export interface MimicServerConfig<TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive> {
+export interface MimicServerConfig<
+  TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive,
+> {
   /**
    * The schema defining the document structure.
    */
@@ -54,12 +79,22 @@ export interface MimicServerConfig<TSchema extends Primitive.AnyPrimitive = Prim
    * @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.
  */
-export interface MimicServerConfigOptions<TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive> {
+export interface MimicServerConfigOptions<
+  TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive,
+> {
   /**
    * The schema defining the document structure.
    */
@@ -95,21 +130,66 @@ export interface MimicServerConfigOptions<TSchema extends Primitive.AnyPrimitive
    * @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>;
 }
 
+/**
+ * Check if a value is an InitialFn (function) rather than a plain object.
+ */
+const isInitialFn = <TSchema extends Primitive.AnyPrimitive>(
+  value: Primitive.InferSetInput<TSchema> | InitialFn<TSchema> | undefined
+): value is InitialFn<TSchema> => typeof value === "function";
+
 /**
  * Create a MimicServerConfig from options.
  */
 export const make = <TSchema extends Primitive.AnyPrimitive>(
   options: MimicServerConfigOptions<TSchema>
-): MimicServerConfig<TSchema> => ({
-  schema: options.schema,
-  maxIdleTime: Duration.decode(options.maxIdleTime ?? "5 minutes"),
-  maxTransactionHistory: options.maxTransactionHistory ?? 1000,
-  heartbeatInterval: Duration.decode(options.heartbeatInterval ?? "30 seconds"),
-  heartbeatTimeout: Duration.decode(options.heartbeatTimeout ?? "10 seconds"),
-  presence: options.presence,
-});
+): MimicServerConfig<TSchema> => {
+  const { initial, schema } = options;
+
+  // Convert initial to a function that applies defaults
+  const initialFn: InitialFn<TSchema> | undefined = initial === undefined
+    ? undefined
+    : isInitialFn<TSchema>(initial)
+      ? (context) => Effect.map(
+          initial(context),
+          (state) => Primitive.applyDefaults(schema, state as Partial<Primitive.InferState<TSchema>>)
+        ) as Effect.Effect<Primitive.InferSetInput<TSchema>>
+      : () => Effect.succeed(
+          Primitive.applyDefaults(schema, initial as Partial<Primitive.InferState<TSchema>>)
+        ) as Effect.Effect<Primitive.InferSetInput<TSchema>>;
+
+  return {
+    schema,
+    maxIdleTime: Duration.decode(options.maxIdleTime ?? "5 minutes"),
+    maxTransactionHistory: options.maxTransactionHistory ?? 1000,
+    heartbeatInterval: Duration.decode(options.heartbeatInterval ?? "30 seconds"),
+    heartbeatTimeout: Duration.decode(options.heartbeatTimeout ?? "10 seconds"),
+    presence: options.presence,
+    initial: initialFn,
+  };
+};
 
 // =============================================================================
 // Context Tag
@@ -128,4 +208,4 @@ export class MimicServerConfigTag extends Context.Tag(
 export const layer = <TSchema extends Primitive.AnyPrimitive>(
   options: MimicServerConfigOptions<TSchema>
 ): Layer.Layer<MimicServerConfigTag> =>
-  Layer.succeed(MimicServerConfigTag, make(options));
+  Layer.succeed(MimicServerConfigTag, make(options) as unknown as MimicServerConfig);