@voidhash/mimic-effect 0.0.2 → 0.0.4

package/dist/MimicDataStorage.mjs

@@ -0,0 +1,74 @@
+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 Data from "effect/Data";
+
+//#region src/MimicDataStorage.ts
+/**
+* @since 0.0.1
+* Data storage service interface for Mimic documents.
+* Provides pluggable storage adapters with load/save hooks for data transformation.
+*/
+var MimicDataStorage_exports = /* @__PURE__ */ __export({
+	MimicDataStorageTag: () => MimicDataStorageTag,
+	StorageDeleteError: () => StorageDeleteError,
+	StorageLoadError: () => StorageLoadError,
+	StorageSaveError: () => StorageSaveError,
+	layer: () => layer,
+	layerEffect: () => layerEffect,
+	make: () => make
+});
+/**
+* Error when loading a document from storage fails.
+*/
+var StorageLoadError = class extends Data.TaggedError("StorageLoadError") {
+	get message() {
+		return `Failed to load document ${this.documentId}: ${String(this.cause)}`;
+	}
+};
+/**
+* Error when saving a document to storage fails.
+*/
+var StorageSaveError = class extends Data.TaggedError("StorageSaveError") {
+	get message() {
+		return `Failed to save document ${this.documentId}: ${String(this.cause)}`;
+	}
+};
+/**
+* Error when deleting a document from storage fails.
+*/
+var StorageDeleteError = class extends Data.TaggedError("StorageDeleteError") {
+	get message() {
+		return `Failed to delete document ${this.documentId}: ${String(this.cause)}`;
+	}
+};
+/**
+* Context tag for MimicDataStorage service.
+*/
+var MimicDataStorageTag = class extends Context.Tag("@voidhash/mimic-server-effect/MimicDataStorage")() {};
+/**
+* Create a MimicDataStorage layer from a storage implementation.
+*/
+const layer = (storage) => Layer.succeed(MimicDataStorageTag, storage);
+/**
+* Create a MimicDataStorage layer from an Effect that produces a storage implementation.
+*/
+const layerEffect = (effect) => Layer.effect(MimicDataStorageTag, effect);
+/**
+* Create a simple storage implementation with minimal configuration.
+*/
+const make = (options) => {
+	var _options$delete, _options$onLoad, _options$onSave;
+	return {
+		load: options.load,
+		save: options.save,
+		delete: (_options$delete = options.delete) !== null && _options$delete !== void 0 ? _options$delete : (() => Effect.void),
+		onLoad: (_options$onLoad = options.onLoad) !== null && _options$onLoad !== void 0 ? _options$onLoad : ((state) => Effect.succeed(state)),
+		onSave: (_options$onSave = options.onSave) !== null && _options$onSave !== void 0 ? _options$onSave : ((state) => Effect.succeed(state))
+	};
+};
+
+//#endregion
+export { MimicDataStorageTag, MimicDataStorage_exports };
+//# sourceMappingURL=MimicDataStorage.mjs.map

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,122 @@
+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_platform = require("@effect/platform");
+
+//#region src/MimicServer.ts
+/**
+* @since 0.0.1
+* Mimic server layer composition.
+*/
+var MimicServer_exports = /* @__PURE__ */ require_rolldown_runtime.__export({
+	documentManagerLayer: () => documentManagerLayer,
+	layerHttpLayerRouter: () => layerHttpLayerRouter
+});
+/**
+* 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));
+/**
+* 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,
+		initial: options.initial
+	});
+	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,106 @@
+import { MimicServerConfigOptions } from "./MimicConfig.cjs";
+import { MimicDataStorageTag } from "./MimicDataStorage.cjs";
+import { DocumentManagerTag } from "./DocumentManager.cjs";
+import { MimicAuthServiceTag } from "./MimicAuthService.cjs";
+import * as Layer from "effect/Layer";
+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, documentManagerLayer, layerHttpLayerRouter };
+}
+/**
+ * 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;
+  /**
+   * Initial state for new documents.
+   * Used when a document is created and no existing state is found in storage.
+   *
+   * Type-safe: required fields (without defaults) must be provided,
+   * while optional fields and fields with defaults can be omitted.
+   *
+   * @default undefined (documents start empty or use schema defaults)
+   */
+  readonly initial?: Primitive.InferSetInput<TSchema>;
+}
+/**
+ * Create the document manager layer.
+ */
+declare const documentManagerLayer: <TSchema extends Primitive.AnyPrimitive>(options: MimicServerConfigOptions<TSchema>) => Layer.Layer<DocumentManagerTag>;
+/**
+ * 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":";;;;;;;;;;;;;;;;UA6BiB,kCAAkC,SAAA,CAAU;;;;;EAA5C,SAAA,QAAA,CAAA,EAKK,SALY;EAAiB;;;EAmB7B,SAAS,MAAA,EAVZ,OAUY;EAUc;;;AAO7C;EAAqD,SAAU,qBAAA,CAAA,EAAA,MAAA;EACf;;;;EAClC,SAAA,QAAA,CAAA,EAnBQ,QAAA,CAAS,WAmBjB;EAyGD;;;;;;;;;EAMV,SAAA,OAAA,CAAA,EAxHkB,SAAA,CAAU,aAwH5B,CAxH0C,OAwH1C,CAAA;;;;;cAjHU,uCAAwC,SAAA,CAAU,uBACpD,yBAAqC,aAC7C,KAAA,CAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAyGF,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,106 @@
+import { MimicServerConfigOptions } from "./MimicConfig.mjs";
+import { MimicDataStorageTag } from "./MimicDataStorage.mjs";
+import { DocumentManagerTag } from "./DocumentManager.mjs";
+import { MimicAuthServiceTag } from "./MimicAuthService.mjs";
+import * as Layer from "effect/Layer";
+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, documentManagerLayer, layerHttpLayerRouter };
+}
+/**
+ * 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;
+  /**
+   * Initial state for new documents.
+   * Used when a document is created and no existing state is found in storage.
+   *
+   * Type-safe: required fields (without defaults) must be provided,
+   * while optional fields and fields with defaults can be omitted.
+   *
+   * @default undefined (documents start empty or use schema defaults)
+   */
+  readonly initial?: Primitive.InferSetInput<TSchema>;
+}
+/**
+ * Create the document manager layer.
+ */
+declare const documentManagerLayer: <TSchema extends Primitive.AnyPrimitive>(options: MimicServerConfigOptions<TSchema>) => Layer.Layer<DocumentManagerTag>;
+/**
+ * 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":";;;;;;;;;;;;;;;;UA6BiB,kCAAkC,SAAA,CAAU;;;;;EAA5C,SAAA,QAAA,CAAA,EAKK,SALY;EAAiB;;;EAmB7B,SAAS,MAAA,EAVZ,OAUY;EAUc;;;AAO7C;EAAqD,SAAU,qBAAA,CAAA,EAAA,MAAA;EACf;;;;EAClC,SAAA,QAAA,CAAA,EAnBQ,QAAA,CAAS,WAmBjB;EAyGD;;;;;;;;;EAMV,SAAA,OAAA,CAAA,EAxHkB,SAAA,CAAU,aAwH5B,CAxH0C,OAwH1C,CAAA;;;;;cAjHU,uCAAwC,SAAA,CAAU,uBACpD,yBAAqC,aAC7C,KAAA,CAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAyGF,uCAAwC,SAAA,CAAU,uBACpD,kBAAkB;;uBAEJ,KAAA,CAAM,MAAM;;0BAET,KAAA,CAAM,MAAM;MACrC,KAAA,CAAA,oBAAA,eAAA,CAAA"}

package/dist/MimicServer.mjs

@@ -0,0 +1,116 @@
+import { __export } from "./_virtual/rolldown_runtime.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$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 { HttpLayerRouter, HttpServerRequest, HttpServerResponse } from "@effect/platform";
+
+//#region src/MimicServer.ts
+/**
+* @since 0.0.1
+* Mimic server layer composition.
+*/
+var MimicServer_exports = /* @__PURE__ */ __export({
+	documentManagerLayer: () => documentManagerLayer,
+	layerHttpLayerRouter: () => layerHttpLayerRouter
+});
+/**
+* Create the document manager layer.
+*/
+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:
+* 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.gen(function* () {
+	const config = yield* MimicServerConfigTag;
+	const authService = yield* MimicAuthServiceTag;
+	const documentManager = yield* DocumentManagerTag;
+	const presenceManager = yield* PresenceManagerTag;
+	return Effect.gen(function* () {
+		const request = yield* HttpServerRequest.HttpServerRequest;
+		yield* extractDocumentId(request.url);
+		const socket = yield* request.upgrade;
+		yield* handleConnection(socket, request.url).pipe(Effect.provideService(MimicServerConfigTag, config), Effect.provideService(MimicAuthServiceTag, authService), Effect.provideService(DocumentManagerTag, documentManager), Effect.provideService(PresenceManagerTag, presenceManager), Effect.scoped, Effect.catchAll((error) => Effect.logError("WebSocket connection error", error)));
+		return HttpServerResponse.empty();
+	}).pipe(Effect.catchAll((error) => Effect.gen(function* () {
+		yield* Effect.logWarning("WebSocket upgrade failed", error);
+		return 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 = 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 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$1), Layer.provide(layer$2), Layer.provide(configLayer), Layer.provide(storageLayer), Layer.provide(authLayer));
+};
+
+//#endregion
+export { MimicServer_exports };
+//# sourceMappingURL=MimicServer.mjs.map

package/dist/MimicServer.mjs.map

@@ -0,0 +1 @@
+{"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<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   * Initial state for new documents.\n   * Used when a document is created and no existing state is found in storage.\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>;\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 * 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    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  // 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":";;;;;;;;;;;;;;;;;;;;;;;;AAiEA,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkDF,MAAa,wBACX,YAMG;;CAIH,MAAMG,SAAoB,wBADT,QAAQ,yEAAY,SACC;CAGtC,MAAM,cAAcR,MAAkB;EACpC,QAAQ,QAAQ;EAChB,uBAAuB,QAAQ;EAC/B,UAAU,QAAQ;EAClB,SAAS,QAAQ;EAClB,CAAC;CAGF,MAAM,kCAAY,QAAQ,4EAAaE;CACvC,MAAM,wCAAe,QAAQ,qFAAgBD;CAG7C,MAAM,gBAAgB,OAAO,IAAI,aAAa;EAC5C,MAAM,SAAS,OAAO,gBAAgB;EACtC,MAAM,UAAU,OAAO;AACvB,SAAO,OAAO,IAAI,OAAO,QAAQ,QAAQ;GACzC;AAGF,QAAO,MAAM,cAAc,cAAc,CAAC,KACxC,MAAM,QAAQQ,QAAsB,EACpC,MAAM,QAAQC,QAAsB,EACpC,MAAM,QAAQ,YAAY,EAC1B,MAAM,QAAQ,aAAa,EAC3B,MAAM,QAAQ,UAAU,CACzB"}