@voidhash/mimic-effect 0.0.1 → 0.0.3

package/dist/MimicDataStorage.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"MimicDataStorage.mjs","names":[],"sources":["../src/MimicDataStorage.ts"],"sourcesContent":["/**\n * @since 0.0.1\n * Data storage service interface for Mimic documents.\n * Provides pluggable storage adapters with load/save hooks for data transformation.\n */\nimport * as Effect from \"effect/Effect\";\nimport * as Context from \"effect/Context\";\nimport * as Layer from \"effect/Layer\";\nimport * as Data from \"effect/Data\";\n\n// =============================================================================\n// Error Types\n// =============================================================================\n\n/**\n * Error when loading a document from storage fails.\n */\nexport class StorageLoadError extends Data.TaggedError(\"StorageLoadError\")<{\n  readonly documentId: string;\n  readonly cause: unknown;\n}> {\n  override get message(): string {\n    return `Failed to load document ${this.documentId}: ${String(this.cause)}`;\n  }\n}\n\n/**\n * Error when saving a document to storage fails.\n */\nexport class StorageSaveError extends Data.TaggedError(\"StorageSaveError\")<{\n  readonly documentId: string;\n  readonly cause: unknown;\n}> {\n  override get message(): string {\n    return `Failed to save document ${this.documentId}: ${String(this.cause)}`;\n  }\n}\n\n/**\n * Error when deleting a document from storage fails.\n */\nexport class StorageDeleteError extends Data.TaggedError(\"StorageDeleteError\")<{\n  readonly documentId: string;\n  readonly cause: unknown;\n}> {\n  override get message(): string {\n    return `Failed to delete document ${this.documentId}: ${String(this.cause)}`;\n  }\n}\n\n/**\n * Union of all storage errors.\n */\nexport type StorageError = StorageLoadError | StorageSaveError | StorageDeleteError;\n\n// =============================================================================\n// Storage Service Interface\n// =============================================================================\n\n/**\n * Data storage service interface.\n * Implementations can persist documents to various backends (memory, S3, database, etc.)\n */\nexport interface MimicDataStorage {\n  /**\n   * Load a document's state from storage.\n   * @param documentId - The unique identifier for the document\n   * @returns The document state, or undefined if not found\n   */\n  readonly load: (\n    documentId: string\n  ) => Effect.Effect<unknown | undefined, StorageLoadError>;\n\n  /**\n   * Save a document's state to storage.\n   * @param documentId - The unique identifier for the document\n   * @param state - The document state to persist\n   */\n  readonly save: (\n    documentId: string,\n    state: unknown\n  ) => Effect.Effect<void, StorageSaveError>;\n\n  /**\n   * Delete a document from storage.\n   * @param documentId - The unique identifier for the document\n   */\n  readonly delete: (\n    documentId: string\n  ) => Effect.Effect<void, StorageDeleteError>;\n\n  /**\n   * Transform data after loading from storage.\n   * Useful for migrations, decryption, decompression, etc.\n   * @param state - The raw state loaded from storage\n   * @returns The transformed state\n   */\n  readonly onLoad: (state: unknown) => Effect.Effect<unknown>;\n\n  /**\n   * Transform/validate data before saving to storage.\n   * Useful for encryption, compression, validation, etc.\n   * @param state - The state to be saved\n   * @returns The transformed state\n   */\n  readonly onSave: (state: unknown) => Effect.Effect<unknown>;\n}\n\n// =============================================================================\n// Context Tag\n// =============================================================================\n\n/**\n * Context tag for MimicDataStorage service.\n */\nexport class MimicDataStorageTag extends Context.Tag(\n  \"@voidhash/mimic-server-effect/MimicDataStorage\"\n)<MimicDataStorageTag, MimicDataStorage>() {}\n\n// =============================================================================\n// Layer Constructors\n// =============================================================================\n\n/**\n * Create a MimicDataStorage layer from a storage implementation.\n */\nexport const layer = (storage: MimicDataStorage): Layer.Layer<MimicDataStorageTag> =>\n  Layer.succeed(MimicDataStorageTag, storage);\n\n/**\n * Create a MimicDataStorage layer from an Effect that produces a storage implementation.\n */\nexport const layerEffect = <E, R>(\n  effect: Effect.Effect<MimicDataStorage, E, R>\n): Layer.Layer<MimicDataStorageTag, E, R> =>\n  Layer.effect(MimicDataStorageTag, effect);\n\n// =============================================================================\n// Helper Functions\n// =============================================================================\n\n/**\n * Create a simple storage implementation with minimal configuration.\n */\nexport const make = (options: {\n  readonly load: (documentId: string) => Effect.Effect<unknown | undefined, StorageLoadError>;\n  readonly save: (documentId: string, state: unknown) => Effect.Effect<void, StorageSaveError>;\n  readonly delete?: (documentId: string) => Effect.Effect<void, StorageDeleteError>;\n  readonly onLoad?: (state: unknown) => Effect.Effect<unknown>;\n  readonly onSave?: (state: unknown) => Effect.Effect<unknown>;\n}): MimicDataStorage => ({\n  load: options.load,\n  save: options.save,\n  delete: options.delete ?? (() => Effect.void),\n  onLoad: options.onLoad ?? ((state) => Effect.succeed(state)),\n  onSave: options.onSave ?? ((state) => Effect.succeed(state)),\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAiBA,IAAa,mBAAb,cAAsC,KAAK,YAAY,mBAAmB,CAGvE;CACD,IAAa,UAAkB;AAC7B,SAAO,2BAA2B,KAAK,WAAW,IAAI,OAAO,KAAK,MAAM;;;;;;AAO5E,IAAa,mBAAb,cAAsC,KAAK,YAAY,mBAAmB,CAGvE;CACD,IAAa,UAAkB;AAC7B,SAAO,2BAA2B,KAAK,WAAW,IAAI,OAAO,KAAK,MAAM;;;;;;AAO5E,IAAa,qBAAb,cAAwC,KAAK,YAAY,qBAAqB,CAG3E;CACD,IAAa,UAAkB;AAC7B,SAAO,6BAA6B,KAAK,WAAW,IAAI,OAAO,KAAK,MAAM;;;;;;AAqE9E,IAAa,sBAAb,cAAyC,QAAQ,IAC/C,iDACD,EAAyC,CAAC;;;;AAS3C,MAAa,SAAS,YACpB,MAAM,QAAQ,qBAAqB,QAAQ;;;;AAK7C,MAAa,eACX,WAEA,MAAM,OAAO,qBAAqB,OAAO;;;;AAS3C,MAAa,QAAQ,YAMG;;QAAC;EACvB,MAAM,QAAQ;EACd,MAAM,QAAQ;EACd,2BAAQ,QAAQ,0EAAiB,OAAO;EACxC,2BAAQ,QAAQ,qEAAY,UAAU,OAAO,QAAQ,MAAM;EAC3D,2BAAQ,QAAQ,qEAAY,UAAU,OAAO,QAAQ,MAAM;EAC5D"}

package/dist/MimicServer.cjs

@@ -0,0 +1,230 @@
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+const require_MimicConfig = require('./MimicConfig.cjs');
+const require_DocumentManager = require('./DocumentManager.cjs');
+const require_MimicAuthService = require('./MimicAuthService.cjs');
+const require_PresenceManager = require('./PresenceManager.cjs');
+const require_WebSocketHandler = require('./WebSocketHandler.cjs');
+const require_InMemoryDataStorage = require('./storage/InMemoryDataStorage.cjs');
+const require_NoAuth = require('./auth/NoAuth.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_platform_SocketServer = require("@effect/platform/SocketServer");
+let _effect_platform = require("@effect/platform");
+
+//#region src/MimicServer.ts
+/**
+* @since 0.0.1
+* Mimic server layer composition.
+*/
+var MimicServer_exports = /* @__PURE__ */ require_rolldown_runtime.__export({
+	MimicWebSocketHandler: () => MimicWebSocketHandler,
+	documentManagerLayer: () => documentManagerLayer,
+	handlerLayer: () => handlerLayer,
+	layer: () => layer,
+	layerHttpLayerRouter: () => layerHttpLayerRouter,
+	run: () => run
+});
+/**
+* Tag for the WebSocket handler function.
+*/
+var MimicWebSocketHandler = class extends effect_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 = require_MimicConfig.layer({
+		schema: options.schema,
+		maxTransactionHistory: options.maxTransactionHistory,
+		presence: options.presence
+	});
+	return effect_Layer.merge(effect_Layer.effect(MimicWebSocketHandler, require_WebSocketHandler.makeHandler).pipe(effect_Layer.provide(require_DocumentManager.layer), effect_Layer.provide(require_PresenceManager.layer), effect_Layer.provide(configLayer)), require_DocumentManager.layer.pipe(effect_Layer.provide(configLayer))).pipe(effect_Layer.provide(require_InMemoryDataStorage.layerDefault), effect_Layer.provide(require_NoAuth.layerDefault));
+};
+/**
+* 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) => effect_Layer.effect(MimicWebSocketHandler, require_WebSocketHandler.makeHandler).pipe(effect_Layer.provide(require_DocumentManager.layer), effect_Layer.provide(require_PresenceManager.layer), effect_Layer.provide(require_MimicConfig.layer(options)), effect_Layer.provide(require_InMemoryDataStorage.layerDefault), effect_Layer.provide(require_NoAuth.layerDefault));
+/**
+* Create the document manager layer.
+*/
+const documentManagerLayer = (options) => require_DocumentManager.layer.pipe(effect_Layer.provide(require_MimicConfig.layer(options)), effect_Layer.provide(require_InMemoryDataStorage.layerDefault), effect_Layer.provide(require_NoAuth.layerDefault));
+/**
+* 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_Effect.gen(function* () {
+	const handler = yield* MimicWebSocketHandler;
+	yield* (yield* _effect_platform_SocketServer.SocketServer).run((socket) => effect_Effect.gen(function* () {
+		yield* handler(socket, yield* extractDocumentId$1(socket));
+	}).pipe(effect_Effect.catchAll((error) => effect_Effect.logError("Connection error", error))));
+});
+/**
+* Create the HTTP handler effect for WebSocket upgrade.
+* This handler:
+* 1. Extracts the document ID from the URL path
+* 2. Upgrades the HTTP connection to WebSocket
+* 3. Delegates to the WebSocketHandler for document sync
+*/
+const makeMimicHandler = effect_Effect.gen(function* () {
+	const config = yield* require_MimicConfig.MimicServerConfigTag;
+	const authService = yield* require_MimicAuthService.MimicAuthServiceTag;
+	const documentManager = yield* require_DocumentManager.DocumentManagerTag;
+	const presenceManager = yield* require_PresenceManager.PresenceManagerTag;
+	return effect_Effect.gen(function* () {
+		const request = yield* _effect_platform.HttpServerRequest.HttpServerRequest;
+		yield* require_WebSocketHandler.extractDocumentId(request.url);
+		const socket = yield* request.upgrade;
+		yield* require_WebSocketHandler.handleConnection(socket, request.url).pipe(effect_Effect.provideService(require_MimicConfig.MimicServerConfigTag, config), effect_Effect.provideService(require_MimicAuthService.MimicAuthServiceTag, authService), effect_Effect.provideService(require_DocumentManager.DocumentManagerTag, documentManager), effect_Effect.provideService(require_PresenceManager.PresenceManagerTag, presenceManager), effect_Effect.scoped, effect_Effect.catchAll((error) => effect_Effect.logError("WebSocket connection error", error)));
+		return _effect_platform.HttpServerResponse.empty();
+	}).pipe(effect_Effect.catchAll((error) => effect_Effect.gen(function* () {
+		yield* effect_Effect.logWarning("WebSocket upgrade failed", error);
+		return _effect_platform.HttpServerResponse.text("WebSocket upgrade failed", { status: 400 });
+	})));
+});
+/**
+* Create a Mimic server layer that integrates with HttpLayerRouter.
+*
+* This function creates a layer that:
+* 1. Registers a WebSocket route at the specified base path
+* 2. Handles WebSocket upgrades for document sync
+* 3. Provides all required dependencies (config, auth, storage, document manager)
+*
+* By default, uses in-memory storage and no authentication.
+* To override these defaults, provide custom layers before the defaults:
+*
+* @example
+* ```typescript
+* import { MimicServer, MimicAuthService } from "@voidhash/mimic-effect";
+* import { HttpLayerRouter } from "@effect/platform";
+* import { Primitive } from "@voidhash/mimic";
+*
+* const TodoSchema = Primitive.Struct({
+*   title: Primitive.String(),
+*   completed: Primitive.Boolean(),
+* });
+*
+* // Create the Mimic route layer with defaults
+* const MimicRoute = MimicServer.layerHttpLayerRouter({
+*   basePath: "/mimic/todo",
+*   schema: TodoSchema
+* });
+*
+* // Or with custom auth - use Layer.provide to inject before defaults
+* const MimicRouteWithAuth = MimicServer.layerHttpLayerRouter({
+*   basePath: "/mimic/todo",
+*   schema: TodoSchema,
+*   authLayer: MimicAuthService.layer({
+*     authHandler: (token) => ({ success: true, userId: token })
+*   })
+* });
+*
+* // Merge with other routes and serve
+* const AllRoutes = Layer.mergeAll(MimicRoute, OtherRoutes);
+* HttpLayerRouter.serve(AllRoutes).pipe(
+*   Layer.provide(BunHttpServer.layer({ port: 3000 })),
+*   Layer.launch,
+*   BunRuntime.runMain
+* );
+* ```
+*/
+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 = require_MimicConfig.layer({
+		schema: options.schema,
+		maxTransactionHistory: options.maxTransactionHistory,
+		presence: options.presence
+	});
+	const authLayer = (_options$authLayer = options.authLayer) !== null && _options$authLayer !== void 0 ? _options$authLayer : require_NoAuth.layerDefault;
+	const storageLayer = (_options$storageLayer = options.storageLayer) !== null && _options$storageLayer !== void 0 ? _options$storageLayer : require_InMemoryDataStorage.layerDefault;
+	const registerRoute = effect_Effect.gen(function* () {
+		const router = yield* _effect_platform.HttpLayerRouter.HttpRouter;
+		const handler = yield* makeMimicHandler;
+		yield* router.add("GET", wsPath, handler);
+	});
+	return effect_Layer.scopedDiscard(registerRoute).pipe(effect_Layer.provide(require_DocumentManager.layer), effect_Layer.provide(require_PresenceManager.layer), effect_Layer.provide(configLayer), effect_Layer.provide(storageLayer), effect_Layer.provide(authLayer));
+};
+
+//#endregion
+Object.defineProperty(exports, 'MimicServer_exports', {
+  enumerable: true,
+  get: function () {
+    return MimicServer_exports;
+  }
+});

package/dist/MimicServer.d.cts

@@ -0,0 +1,192 @@
+import { MimicServerConfigOptions } from "./MimicConfig.cjs";
+import { MimicDataStorageTag } from "./MimicDataStorage.cjs";
+import { DocumentManagerTag } from "./DocumentManager.cjs";
+import { MimicAuthServiceTag } from "./MimicAuthService.cjs";
+import * as _effect_platform_SocketServer0 from "@effect/platform/SocketServer";
+import { SocketServer } from "@effect/platform/SocketServer";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Context from "effect/Context";
+import * as Socket from "@effect/platform/Socket";
+import { Presence, Primitive } from "@voidhash/mimic";
+import { HttpLayerRouter } from "@effect/platform";
+import { PathInput } from "@effect/platform/HttpRouter";
+
+//#region src/MimicServer.d.ts
+declare namespace MimicServer_d_exports {
+  export { MimicLayerOptions, MimicWebSocketHandler, documentManagerLayer, handlerLayer, layer, layerHttpLayerRouter, run };
+}
+declare const MimicWebSocketHandler_base: Context.TagClass<MimicWebSocketHandler, "@voidhash/mimic-server-effect/MimicWebSocketHandler", (socket: Socket.Socket, documentId: string) => Effect.Effect<void, unknown>>;
+/**
+ * Tag for the WebSocket handler function.
+ */
+declare class MimicWebSocketHandler extends MimicWebSocketHandler_base {}
+/**
+ * Options for creating a Mimic server layer.
+ */
+interface MimicLayerOptions<TSchema extends Primitive.AnyPrimitive> {
+  /**
+   * Base path for document routes (used for path matching).
+   * @example "/mimic/todo" - documents accessed at "/mimic/todo/:documentId"
+   */
+  readonly basePath?: PathInput;
+  /**
+   * The schema defining the document structure.
+   */
+  readonly schema: TSchema;
+  /**
+   * Maximum number of processed transaction IDs to track for deduplication.
+   * @default 1000
+   */
+  readonly maxTransactionHistory?: number;
+  /**
+   * Optional presence schema for ephemeral per-user data.
+   * When provided, enables presence features on WebSocket connections.
+   */
+  readonly presence?: Presence.AnyPresence;
+}
+/**
+ * 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" })
+ *   }))
+ * );
+ * ```
+ */
+declare const layer: <TSchema extends Primitive.AnyPrimitive>(options: MimicLayerOptions<TSchema>) => Layer.Layer<MimicWebSocketHandler | DocumentManagerTag>;
+/**
+ * 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),
+ * );
+ * ```
+ */
+declare const handlerLayer: <TSchema extends Primitive.AnyPrimitive>(options: MimicServerConfigOptions<TSchema>) => Layer.Layer<MimicWebSocketHandler>;
+/**
+ * Create the document manager layer.
+ */
+declare const documentManagerLayer: <TSchema extends Primitive.AnyPrimitive>(options: MimicServerConfigOptions<TSchema>) => Layer.Layer<DocumentManagerTag>;
+/**
+ * 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.
+ */
+declare const run: (extractDocumentId: (socket: Socket.Socket) => Effect.Effect<string>) => Effect.Effect<void, _effect_platform_SocketServer0.SocketServerError, MimicWebSocketHandler | SocketServer>;
+/**
+ * Create a Mimic server layer that integrates with HttpLayerRouter.
+ *
+ * This function creates a layer that:
+ * 1. Registers a WebSocket route at the specified base path
+ * 2. Handles WebSocket upgrades for document sync
+ * 3. Provides all required dependencies (config, auth, storage, document manager)
+ *
+ * By default, uses in-memory storage and no authentication.
+ * To override these defaults, provide custom layers before the defaults:
+ *
+ * @example
+ * ```typescript
+ * import { MimicServer, MimicAuthService } from "@voidhash/mimic-effect";
+ * import { HttpLayerRouter } from "@effect/platform";
+ * import { Primitive } from "@voidhash/mimic";
+ *
+ * const TodoSchema = Primitive.Struct({
+ *   title: Primitive.String(),
+ *   completed: Primitive.Boolean(),
+ * });
+ *
+ * // Create the Mimic route layer with defaults
+ * const MimicRoute = MimicServer.layerHttpLayerRouter({
+ *   basePath: "/mimic/todo",
+ *   schema: TodoSchema
+ * });
+ *
+ * // Or with custom auth - use Layer.provide to inject before defaults
+ * const MimicRouteWithAuth = MimicServer.layerHttpLayerRouter({
+ *   basePath: "/mimic/todo",
+ *   schema: TodoSchema,
+ *   authLayer: MimicAuthService.layer({
+ *     authHandler: (token) => ({ success: true, userId: token })
+ *   })
+ * });
+ *
+ * // Merge with other routes and serve
+ * const AllRoutes = Layer.mergeAll(MimicRoute, OtherRoutes);
+ * HttpLayerRouter.serve(AllRoutes).pipe(
+ *   Layer.provide(BunHttpServer.layer({ port: 3000 })),
+ *   Layer.launch,
+ *   BunRuntime.runMain
+ * );
+ * ```
+ */
+declare const layerHttpLayerRouter: <TSchema extends Primitive.AnyPrimitive>(options: MimicLayerOptions<TSchema> & {
+  /** Custom auth layer. Defaults to NoAuth (all connections allowed). */
+  readonly authLayer?: Layer.Layer<MimicAuthServiceTag>;
+  /** Custom storage layer. Defaults to InMemoryDataStorage. */
+  readonly storageLayer?: Layer.Layer<MimicDataStorageTag>;
+}) => Layer.Layer<never, never, HttpLayerRouter.HttpRouter>;
+//#endregion
+export { MimicServer_d_exports };
+//# sourceMappingURL=MimicServer.d.cts.map

package/dist/MimicServer.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MimicServer.d.cts","names":[],"sources":["../src/MimicServer.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;cAoBwD,oIAa7C,MAAA,CAAO,+BAA+B,MAAA,CAAO;;;;cAJ3C,qBAAA,SAA8B,0BAAA;;;;AATa,UAuBvC,iBAV4D,CAAA,gBAU1B,SAAA,CAAU,YAVgB,CAAA,CAAA;;;;;sBAevD;EAnBT;AAcb;;EAKsB,SAAA,MAAA,EAIH,OAJG;EAIH;;;AAsDnB;EAAsC,SAAU,qBAAA,CAAA,EAAA,MAAA;EACnB;;;;EAC1B,SAAM,QAAA,CAAA,EA9Ca,QAAA,CAAS,WA8CtB;;AA2DT;;;;;;;AAeA;;;;;;;AAwBA;;;;;;;;AAqHA;;;;;;;;;;;;;;;cAzNa,wBAAyB,SAAA,CAAU,uBACrC,kBAAkB,aAC1B,KAAA,CAAM,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA2D1B,+BAAgC,SAAA,CAAU,uBAC5C,yBAAqC,aAC7C,KAAA,CAAM,MAAM;;;;cAaF,uCAAwC,SAAA,CAAU,uBACpD,yBAAqC,aAC7C,KAAA,CAAM,MAAM;;;;;;;;;;;cAsBF,kCACiB,MAAA,CAAO,WAAW,MAAA,CAAO,mBAAc,MAAA,CAAA,aAAR,8BAAA,CAAQ,iBAAA,EAAA,wBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAoHxD,uCAAwC,SAAA,CAAU,uBACpD,kBAAkB;;uBAEJ,KAAA,CAAM,MAAM;;0BAET,KAAA,CAAM,MAAM;MACrC,KAAA,CAAA,oBAAA,eAAA,CAAA"}

package/dist/MimicServer.d.mts

@@ -0,0 +1,192 @@
+import { MimicServerConfigOptions } from "./MimicConfig.mjs";
+import { MimicDataStorageTag } from "./MimicDataStorage.mjs";
+import { DocumentManagerTag } from "./DocumentManager.mjs";
+import { MimicAuthServiceTag } from "./MimicAuthService.mjs";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Context from "effect/Context";
+import * as _effect_platform_SocketServer0 from "@effect/platform/SocketServer";
+import { SocketServer } from "@effect/platform/SocketServer";
+import { Presence, Primitive } from "@voidhash/mimic";
+import { HttpLayerRouter } from "@effect/platform";
+import * as Socket from "@effect/platform/Socket";
+import { PathInput } from "@effect/platform/HttpRouter";
+
+//#region src/MimicServer.d.ts
+declare namespace MimicServer_d_exports {
+  export { MimicLayerOptions, MimicWebSocketHandler, documentManagerLayer, handlerLayer, layer, layerHttpLayerRouter, run };
+}
+declare const MimicWebSocketHandler_base: Context.TagClass<MimicWebSocketHandler, "@voidhash/mimic-server-effect/MimicWebSocketHandler", (socket: Socket.Socket, documentId: string) => Effect.Effect<void, unknown>>;
+/**
+ * Tag for the WebSocket handler function.
+ */
+declare class MimicWebSocketHandler extends MimicWebSocketHandler_base {}
+/**
+ * Options for creating a Mimic server layer.
+ */
+interface MimicLayerOptions<TSchema extends Primitive.AnyPrimitive> {
+  /**
+   * Base path for document routes (used for path matching).
+   * @example "/mimic/todo" - documents accessed at "/mimic/todo/:documentId"
+   */
+  readonly basePath?: PathInput;
+  /**
+   * The schema defining the document structure.
+   */
+  readonly schema: TSchema;
+  /**
+   * Maximum number of processed transaction IDs to track for deduplication.
+   * @default 1000
+   */
+  readonly maxTransactionHistory?: number;
+  /**
+   * Optional presence schema for ephemeral per-user data.
+   * When provided, enables presence features on WebSocket connections.
+   */
+  readonly presence?: Presence.AnyPresence;
+}
+/**
+ * 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" })
+ *   }))
+ * );
+ * ```
+ */
+declare const layer: <TSchema extends Primitive.AnyPrimitive>(options: MimicLayerOptions<TSchema>) => Layer.Layer<MimicWebSocketHandler | DocumentManagerTag>;
+/**
+ * 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),
+ * );
+ * ```
+ */
+declare const handlerLayer: <TSchema extends Primitive.AnyPrimitive>(options: MimicServerConfigOptions<TSchema>) => Layer.Layer<MimicWebSocketHandler>;
+/**
+ * Create the document manager layer.
+ */
+declare const documentManagerLayer: <TSchema extends Primitive.AnyPrimitive>(options: MimicServerConfigOptions<TSchema>) => Layer.Layer<DocumentManagerTag>;
+/**
+ * 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.
+ */
+declare const run: (extractDocumentId: (socket: Socket.Socket) => Effect.Effect<string>) => Effect.Effect<void, _effect_platform_SocketServer0.SocketServerError, MimicWebSocketHandler | SocketServer>;
+/**
+ * Create a Mimic server layer that integrates with HttpLayerRouter.
+ *
+ * This function creates a layer that:
+ * 1. Registers a WebSocket route at the specified base path
+ * 2. Handles WebSocket upgrades for document sync
+ * 3. Provides all required dependencies (config, auth, storage, document manager)
+ *
+ * By default, uses in-memory storage and no authentication.
+ * To override these defaults, provide custom layers before the defaults:
+ *
+ * @example
+ * ```typescript
+ * import { MimicServer, MimicAuthService } from "@voidhash/mimic-effect";
+ * import { HttpLayerRouter } from "@effect/platform";
+ * import { Primitive } from "@voidhash/mimic";
+ *
+ * const TodoSchema = Primitive.Struct({
+ *   title: Primitive.String(),
+ *   completed: Primitive.Boolean(),
+ * });
+ *
+ * // Create the Mimic route layer with defaults
+ * const MimicRoute = MimicServer.layerHttpLayerRouter({
+ *   basePath: "/mimic/todo",
+ *   schema: TodoSchema
+ * });
+ *
+ * // Or with custom auth - use Layer.provide to inject before defaults
+ * const MimicRouteWithAuth = MimicServer.layerHttpLayerRouter({
+ *   basePath: "/mimic/todo",
+ *   schema: TodoSchema,
+ *   authLayer: MimicAuthService.layer({
+ *     authHandler: (token) => ({ success: true, userId: token })
+ *   })
+ * });
+ *
+ * // Merge with other routes and serve
+ * const AllRoutes = Layer.mergeAll(MimicRoute, OtherRoutes);
+ * HttpLayerRouter.serve(AllRoutes).pipe(
+ *   Layer.provide(BunHttpServer.layer({ port: 3000 })),
+ *   Layer.launch,
+ *   BunRuntime.runMain
+ * );
+ * ```
+ */
+declare const layerHttpLayerRouter: <TSchema extends Primitive.AnyPrimitive>(options: MimicLayerOptions<TSchema> & {
+  /** Custom auth layer. Defaults to NoAuth (all connections allowed). */
+  readonly authLayer?: Layer.Layer<MimicAuthServiceTag>;
+  /** Custom storage layer. Defaults to InMemoryDataStorage. */
+  readonly storageLayer?: Layer.Layer<MimicDataStorageTag>;
+}) => Layer.Layer<never, never, HttpLayerRouter.HttpRouter>;
+//#endregion
+export { MimicServer_d_exports };
+//# sourceMappingURL=MimicServer.d.mts.map

package/dist/MimicServer.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MimicServer.d.mts","names":[],"sources":["../src/MimicServer.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;cAoBwD,oIAa7C,MAAA,CAAO,+BAA+B,MAAA,CAAO;;;;cAJ3C,qBAAA,SAA8B,0BAAA;;;;AATa,UAuBvC,iBAV4D,CAAA,gBAU1B,SAAA,CAAU,YAVgB,CAAA,CAAA;;;;;sBAevD;EAnBT;AAcb;;EAKsB,SAAA,MAAA,EAIH,OAJG;EAIH;;;AAsDnB;EAAsC,SAAU,qBAAA,CAAA,EAAA,MAAA;EACnB;;;;EAC1B,SAAM,QAAA,CAAA,EA9Ca,QAAA,CAAS,WA8CtB;;AA2DT;;;;;;;AAeA;;;;;;;AAwBA;;;;;;;;AAqHA;;;;;;;;;;;;;;;cAzNa,wBAAyB,SAAA,CAAU,uBACrC,kBAAkB,aAC1B,KAAA,CAAM,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA2D1B,+BAAgC,SAAA,CAAU,uBAC5C,yBAAqC,aAC7C,KAAA,CAAM,MAAM;;;;cAaF,uCAAwC,SAAA,CAAU,uBACpD,yBAAqC,aAC7C,KAAA,CAAM,MAAM;;;;;;;;;;;cAsBF,kCACiB,MAAA,CAAO,WAAW,MAAA,CAAO,mBAAc,MAAA,CAAA,aAAR,8BAAA,CAAQ,iBAAA,EAAA,wBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAoHxD,uCAAwC,SAAA,CAAU,uBACpD,kBAAkB;;uBAEJ,KAAA,CAAM,MAAM;;0BAET,KAAA,CAAM,MAAM;MACrC,KAAA,CAAA,oBAAA,eAAA,CAAA"}