@voidhash/mimic-effect 0.0.1 → 0.0.3

package/dist/MimicConfig.d.cts

@@ -0,0 +1,99 @@
+import * as Layer from "effect/Layer";
+import * as Context from "effect/Context";
+import { Presence, Primitive } from "@voidhash/mimic";
+import * as Duration from "effect/Duration";
+import { DurationInput } from "effect/Duration";
+
+//#region src/MimicConfig.d.ts
+declare namespace MimicConfig_d_exports {
+  export { MimicServerConfig, MimicServerConfigOptions, MimicServerConfigTag, layer, make };
+}
+/**
+ * Configuration for the Mimic server.
+ *
+ * Note: Authentication and persistence are now handled by injectable services
+ * (MimicAuthService and MimicDataStorage) rather than config options.
+ */
+interface MimicServerConfig<TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive> {
+  /**
+   * The schema defining the document structure.
+   */
+  readonly schema: TSchema;
+  /**
+   * Maximum idle time for a document before it is cleaned up.
+   * @default "5 minutes"
+   */
+  readonly maxIdleTime: Duration.Duration;
+  /**
+   * Maximum number of processed transaction IDs to track for deduplication.
+   * @default 1000
+   */
+  readonly maxTransactionHistory: number;
+  /**
+   * Heartbeat interval for WebSocket connections.
+   * @default "30 seconds"
+   */
+  readonly heartbeatInterval: Duration.Duration;
+  /**
+   * Timeout for heartbeat responses before considering connection dead.
+   * @default "10 seconds"
+   */
+  readonly heartbeatTimeout: Duration.Duration;
+  /**
+   * Optional presence schema for ephemeral per-user data.
+   * When provided, enables presence features on WebSocket connections.
+   * @default undefined (presence disabled)
+   */
+  readonly presence: Presence.AnyPresence | undefined;
+}
+/**
+ * Options for creating a MimicServerConfig.
+ */
+interface MimicServerConfigOptions<TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive> {
+  /**
+   * The schema defining the document structure.
+   */
+  readonly schema: TSchema;
+  /**
+   * Maximum idle time for a document before it is cleaned up.
+   * @default "5 minutes"
+   */
+  readonly maxIdleTime?: DurationInput;
+  /**
+   * Maximum number of processed transaction IDs to track for deduplication.
+   * @default 1000
+   */
+  readonly maxTransactionHistory?: number;
+  /**
+   * Heartbeat interval for WebSocket connections.
+   * @default "30 seconds"
+   */
+  readonly heartbeatInterval?: DurationInput;
+  /**
+   * Timeout for heartbeat responses.
+   * @default "10 seconds"
+   */
+  readonly heartbeatTimeout?: DurationInput;
+  /**
+   * Optional presence schema for ephemeral per-user data.
+   * When provided, enables presence features on WebSocket connections.
+   * @default undefined (presence disabled)
+   */
+  readonly presence?: Presence.AnyPresence;
+}
+/**
+ * Create a MimicServerConfig from options.
+ */
+declare const make: <TSchema extends Primitive.AnyPrimitive>(options: MimicServerConfigOptions<TSchema>) => MimicServerConfig<TSchema>;
+declare const MimicServerConfigTag_base: Context.TagClass<MimicServerConfigTag, "@voidhash/mimic-server-effect/MimicServerConfig", MimicServerConfig<Primitive.AnyPrimitive>>;
+/**
+ * Context tag for MimicServerConfig.
+ */
+declare class MimicServerConfigTag extends MimicServerConfigTag_base {}
+/**
+ * Create a Layer that provides MimicServerConfig.
+ */
+declare const layer: <TSchema extends Primitive.AnyPrimitive>(options: MimicServerConfigOptions<TSchema>) => Layer.Layer<MimicServerConfigTag>;
+//#endregion
+export { MimicConfig_d_exports, MimicServerConfigOptions, MimicServerConfigTag };
+//# sourceMappingURL=MimicConfig.d.cts.map

package/dist/MimicConfig.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MimicConfig.d.cts","names":[],"sources":["../src/MimicConfig.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;AAoBiB,UAAA,iBAAiB,CAAA,gBAAiB,SAAA,CAAU,YAA3B,GAA0C,SAAA,CAAU,YAApD,CAAA,CAAA;EAAiB;;;EAU3B,SAAS,MAAA,EANd,OAMc;EAYH;;;;EAmBb,SAAA,WAAA,EA/BO,QAAA,CAAS,QA+BQ;EAAiB;;;;EAsB3B,SAAA,qBAAA,EAAA,MAAA;EAMD;;;AAa9B;EAAqC,SAAU,iBAAA,EA5DjB,QAAA,CAAS,QA4DQ;EACX;;;;EAChB,SAAA,gBAAA,EAxDS,QAAA,CAAS,QAwDlB;EAOjB;;;;;qBAxDkB,QAAA,CAAS;AAiE9B;AAOA;;;AACW,UAnEM,wBAmEN,CAAA,gBAnE+C,SAAA,CAAU,YAmEzD,GAnEwE,SAAA,CAAU,YAmElF,CAAA,CAAA;EACI;;;mBAhEI;;;;;yBAMM;;;;;;;;;;+BAYM;;;;;8BAMD;;;;;;sBAOR,QAAA,CAAS;;;;;cAMlB,uBAAwB,SAAA,CAAU,uBACpC,yBAAyB,aACjC,kBAAkB;cAOlB;;;;cASU,oBAAA,SAA6B,yBAAA;;;;cAO7B,wBAAyB,SAAA,CAAU,uBACrC,yBAAyB,aACjC,KAAA,CAAM,MAAM"}

package/dist/MimicConfig.d.mts

@@ -0,0 +1,99 @@
+import * as Layer from "effect/Layer";
+import * as Context from "effect/Context";
+import * as Duration from "effect/Duration";
+import { DurationInput } from "effect/Duration";
+import { Presence, Primitive } from "@voidhash/mimic";
+
+//#region src/MimicConfig.d.ts
+declare namespace MimicConfig_d_exports {
+  export { MimicServerConfig, MimicServerConfigOptions, MimicServerConfigTag, layer, make };
+}
+/**
+ * Configuration for the Mimic server.
+ *
+ * Note: Authentication and persistence are now handled by injectable services
+ * (MimicAuthService and MimicDataStorage) rather than config options.
+ */
+interface MimicServerConfig<TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive> {
+  /**
+   * The schema defining the document structure.
+   */
+  readonly schema: TSchema;
+  /**
+   * Maximum idle time for a document before it is cleaned up.
+   * @default "5 minutes"
+   */
+  readonly maxIdleTime: Duration.Duration;
+  /**
+   * Maximum number of processed transaction IDs to track for deduplication.
+   * @default 1000
+   */
+  readonly maxTransactionHistory: number;
+  /**
+   * Heartbeat interval for WebSocket connections.
+   * @default "30 seconds"
+   */
+  readonly heartbeatInterval: Duration.Duration;
+  /**
+   * Timeout for heartbeat responses before considering connection dead.
+   * @default "10 seconds"
+   */
+  readonly heartbeatTimeout: Duration.Duration;
+  /**
+   * Optional presence schema for ephemeral per-user data.
+   * When provided, enables presence features on WebSocket connections.
+   * @default undefined (presence disabled)
+   */
+  readonly presence: Presence.AnyPresence | undefined;
+}
+/**
+ * Options for creating a MimicServerConfig.
+ */
+interface MimicServerConfigOptions<TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive> {
+  /**
+   * The schema defining the document structure.
+   */
+  readonly schema: TSchema;
+  /**
+   * Maximum idle time for a document before it is cleaned up.
+   * @default "5 minutes"
+   */
+  readonly maxIdleTime?: DurationInput;
+  /**
+   * Maximum number of processed transaction IDs to track for deduplication.
+   * @default 1000
+   */
+  readonly maxTransactionHistory?: number;
+  /**
+   * Heartbeat interval for WebSocket connections.
+   * @default "30 seconds"
+   */
+  readonly heartbeatInterval?: DurationInput;
+  /**
+   * Timeout for heartbeat responses.
+   * @default "10 seconds"
+   */
+  readonly heartbeatTimeout?: DurationInput;
+  /**
+   * Optional presence schema for ephemeral per-user data.
+   * When provided, enables presence features on WebSocket connections.
+   * @default undefined (presence disabled)
+   */
+  readonly presence?: Presence.AnyPresence;
+}
+/**
+ * Create a MimicServerConfig from options.
+ */
+declare const make: <TSchema extends Primitive.AnyPrimitive>(options: MimicServerConfigOptions<TSchema>) => MimicServerConfig<TSchema>;
+declare const MimicServerConfigTag_base: Context.TagClass<MimicServerConfigTag, "@voidhash/mimic-server-effect/MimicServerConfig", MimicServerConfig<Primitive.AnyPrimitive>>;
+/**
+ * Context tag for MimicServerConfig.
+ */
+declare class MimicServerConfigTag extends MimicServerConfigTag_base {}
+/**
+ * Create a Layer that provides MimicServerConfig.
+ */
+declare const layer: <TSchema extends Primitive.AnyPrimitive>(options: MimicServerConfigOptions<TSchema>) => Layer.Layer<MimicServerConfigTag>;
+//#endregion
+export { MimicConfig_d_exports, MimicServerConfigOptions, MimicServerConfigTag };
+//# sourceMappingURL=MimicConfig.d.mts.map

package/dist/MimicConfig.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MimicConfig.d.mts","names":[],"sources":["../src/MimicConfig.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;AAoBiB,UAAA,iBAAiB,CAAA,gBAAiB,SAAA,CAAU,YAA3B,GAA0C,SAAA,CAAU,YAApD,CAAA,CAAA;EAAiB;;;EAU3B,SAAS,MAAA,EANd,OAMc;EAYH;;;;EAmBb,SAAA,WAAA,EA/BO,QAAA,CAAS,QA+BQ;EAAiB;;;;EAsB3B,SAAA,qBAAA,EAAA,MAAA;EAMD;;;AAa9B;EAAqC,SAAU,iBAAA,EA5DjB,QAAA,CAAS,QA4DQ;EACX;;;;EAChB,SAAA,gBAAA,EAxDS,QAAA,CAAS,QAwDlB;EAOjB;;;;;qBAxDkB,QAAA,CAAS;AAiE9B;AAOA;;;AACW,UAnEM,wBAmEN,CAAA,gBAnE+C,SAAA,CAAU,YAmEzD,GAnEwE,SAAA,CAAU,YAmElF,CAAA,CAAA;EACI;;;mBAhEI;;;;;yBAMM;;;;;;;;;;+BAYM;;;;;8BAMD;;;;;;sBAOR,QAAA,CAAS;;;;;cAMlB,uBAAwB,SAAA,CAAU,uBACpC,yBAAyB,aACjC,kBAAkB;cAOlB;;;;cASU,oBAAA,SAA6B,yBAAA;;;;cAO7B,wBAAyB,SAAA,CAAU,uBACrC,yBAAyB,aACjC,KAAA,CAAM,MAAM"}

package/dist/MimicConfig.mjs

@@ -0,0 +1,41 @@
+import { __export } from "./_virtual/rolldown_runtime.mjs";
+import * as Layer from "effect/Layer";
+import * as Context from "effect/Context";
+import * as Duration from "effect/Duration";
+
+//#region src/MimicConfig.ts
+/**
+* @since 0.0.1
+* Configuration types for the Mimic server.
+*/
+var MimicConfig_exports = /* @__PURE__ */ __export({
+	MimicServerConfigTag: () => MimicServerConfigTag,
+	layer: () => layer,
+	make: () => make
+});
+/**
+* Create a MimicServerConfig from options.
+*/
+const make = (options) => {
+	var _options$maxIdleTime, _options$maxTransacti, _options$heartbeatInt, _options$heartbeatTim;
+	return {
+		schema: options.schema,
+		maxIdleTime: Duration.decode((_options$maxIdleTime = options.maxIdleTime) !== null && _options$maxIdleTime !== void 0 ? _options$maxIdleTime : "5 minutes"),
+		maxTransactionHistory: (_options$maxTransacti = options.maxTransactionHistory) !== null && _options$maxTransacti !== void 0 ? _options$maxTransacti : 1e3,
+		heartbeatInterval: Duration.decode((_options$heartbeatInt = options.heartbeatInterval) !== null && _options$heartbeatInt !== void 0 ? _options$heartbeatInt : "30 seconds"),
+		heartbeatTimeout: Duration.decode((_options$heartbeatTim = options.heartbeatTimeout) !== null && _options$heartbeatTim !== void 0 ? _options$heartbeatTim : "10 seconds"),
+		presence: options.presence
+	};
+};
+/**
+* Context tag for MimicServerConfig.
+*/
+var MimicServerConfigTag = class extends Context.Tag("@voidhash/mimic-server-effect/MimicServerConfig")() {};
+/**
+* Create a Layer that provides MimicServerConfig.
+*/
+const layer = (options) => Layer.succeed(MimicServerConfigTag, make(options));
+
+//#endregion
+export { MimicConfig_exports, MimicServerConfigTag, layer };
+//# sourceMappingURL=MimicConfig.mjs.map

package/dist/MimicConfig.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"MimicConfig.mjs","names":[],"sources":["../src/MimicConfig.ts"],"sourcesContent":["/**\n * @since 0.0.1\n * Configuration types for the Mimic server.\n */\nimport * as Context from \"effect/Context\";\nimport * as Duration from \"effect/Duration\";\nimport type { DurationInput } from \"effect/Duration\";\nimport * as Layer from \"effect/Layer\";\nimport type { Primitive, Presence } from \"@voidhash/mimic\";\n\n// =============================================================================\n// Mimic Server Configuration\n// =============================================================================\n\n/**\n * Configuration for the Mimic server.\n * \n * Note: Authentication and persistence are now handled by injectable services\n * (MimicAuthService and MimicDataStorage) rather than config options.\n */\nexport interface MimicServerConfig<TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive> {\n  /**\n   * The schema defining the document structure.\n   */\n  readonly schema: TSchema;\n\n  /**\n   * Maximum idle time for a document before it is cleaned up.\n   * @default \"5 minutes\"\n   */\n  readonly maxIdleTime: Duration.Duration;\n\n  /**\n   * Maximum number of processed transaction IDs to track for deduplication.\n   * @default 1000\n   */\n  readonly maxTransactionHistory: number;\n\n  /**\n   * Heartbeat interval for WebSocket connections.\n   * @default \"30 seconds\"\n   */\n  readonly heartbeatInterval: Duration.Duration;\n\n  /**\n   * Timeout for heartbeat responses before considering connection dead.\n   * @default \"10 seconds\"\n   */\n  readonly heartbeatTimeout: Duration.Duration;\n\n  /**\n   * Optional presence schema for ephemeral per-user data.\n   * When provided, enables presence features on WebSocket connections.\n   * @default undefined (presence disabled)\n   */\n  readonly presence: Presence.AnyPresence | undefined;\n}\n\n/**\n * Options for creating a MimicServerConfig.\n */\nexport interface MimicServerConfigOptions<TSchema extends Primitive.AnyPrimitive = Primitive.AnyPrimitive> {\n  /**\n   * The schema defining the document structure.\n   */\n  readonly schema: TSchema;\n\n  /**\n   * Maximum idle time for a document before it is cleaned up.\n   * @default \"5 minutes\"\n   */\n  readonly maxIdleTime?: DurationInput;\n\n  /**\n   * Maximum number of processed transaction IDs to track for deduplication.\n   * @default 1000\n   */\n  readonly maxTransactionHistory?: number;\n\n  /**\n   * Heartbeat interval for WebSocket connections.\n   * @default \"30 seconds\"\n   */\n  readonly heartbeatInterval?: DurationInput;\n\n  /**\n   * Timeout for heartbeat responses.\n   * @default \"10 seconds\"\n   */\n  readonly heartbeatTimeout?: DurationInput;\n\n  /**\n   * Optional presence schema for ephemeral per-user data.\n   * When provided, enables presence features on WebSocket connections.\n   * @default undefined (presence disabled)\n   */\n  readonly presence?: Presence.AnyPresence;\n}\n\n/**\n * Create a MimicServerConfig from options.\n */\nexport const make = <TSchema extends Primitive.AnyPrimitive>(\n  options: MimicServerConfigOptions<TSchema>\n): MimicServerConfig<TSchema> => ({\n  schema: options.schema,\n  maxIdleTime: Duration.decode(options.maxIdleTime ?? \"5 minutes\"),\n  maxTransactionHistory: options.maxTransactionHistory ?? 1000,\n  heartbeatInterval: Duration.decode(options.heartbeatInterval ?? \"30 seconds\"),\n  heartbeatTimeout: Duration.decode(options.heartbeatTimeout ?? \"10 seconds\"),\n  presence: options.presence,\n});\n\n// =============================================================================\n// Context Tag\n// =============================================================================\n\n/**\n * Context tag for MimicServerConfig.\n */\nexport class MimicServerConfigTag extends Context.Tag(\n  \"@voidhash/mimic-server-effect/MimicServerConfig\"\n)<MimicServerConfigTag, MimicServerConfig>() {}\n\n/**\n * Create a Layer that provides MimicServerConfig.\n */\nexport const layer = <TSchema extends Primitive.AnyPrimitive>(\n  options: MimicServerConfigOptions<TSchema>\n): Layer.Layer<MimicServerConfigTag> =>\n  Layer.succeed(MimicServerConfigTag, make(options));\n"],"mappings":";;;;;;;;;;;;;;;;;;AAsGA,MAAa,QACX,YAC+B;;QAAC;EAChC,QAAQ,QAAQ;EAChB,aAAa,SAAS,+BAAO,QAAQ,kFAAe,YAAY;EAChE,gDAAuB,QAAQ,8FAAyB;EACxD,mBAAmB,SAAS,gCAAO,QAAQ,0FAAqB,aAAa;EAC7E,kBAAkB,SAAS,gCAAO,QAAQ,yFAAoB,aAAa;EAC3E,UAAU,QAAQ;EACnB;;;;;AASD,IAAa,uBAAb,cAA0C,QAAQ,IAChD,kDACD,EAA2C,CAAC;;;;AAK7C,MAAa,SACX,YAEA,MAAM,QAAQ,sBAAsB,KAAK,QAAQ,CAAC"}

package/dist/MimicDataStorage.cjs

@@ -0,0 +1,83 @@
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+let effect_Effect = require("effect/Effect");
+effect_Effect = require_rolldown_runtime.__toESM(effect_Effect);
+let effect_Layer = require("effect/Layer");
+effect_Layer = require_rolldown_runtime.__toESM(effect_Layer);
+let effect_Context = require("effect/Context");
+effect_Context = require_rolldown_runtime.__toESM(effect_Context);
+let effect_Data = require("effect/Data");
+effect_Data = require_rolldown_runtime.__toESM(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__ */ require_rolldown_runtime.__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 effect_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 effect_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 effect_Data.TaggedError("StorageDeleteError") {
+	get message() {
+		return `Failed to delete document ${this.documentId}: ${String(this.cause)}`;
+	}
+};
+/**
+* Context tag for MimicDataStorage service.
+*/
+var MimicDataStorageTag = class extends effect_Context.Tag("@voidhash/mimic-server-effect/MimicDataStorage")() {};
+/**
+* Create a MimicDataStorage layer from a storage implementation.
+*/
+const layer = (storage) => effect_Layer.succeed(MimicDataStorageTag, storage);
+/**
+* Create a MimicDataStorage layer from an Effect that produces a storage implementation.
+*/
+const layerEffect = (effect) => 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_Effect.void),
+		onLoad: (_options$onLoad = options.onLoad) !== null && _options$onLoad !== void 0 ? _options$onLoad : ((state) => effect_Effect.succeed(state)),
+		onSave: (_options$onSave = options.onSave) !== null && _options$onSave !== void 0 ? _options$onSave : ((state) => effect_Effect.succeed(state))
+	};
+};
+
+//#endregion
+exports.MimicDataStorageTag = MimicDataStorageTag;
+Object.defineProperty(exports, 'MimicDataStorage_exports', {
+  enumerable: true,
+  get: function () {
+    return MimicDataStorage_exports;
+  }
+});

package/dist/MimicDataStorage.d.cts

@@ -0,0 +1,113 @@
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Context from "effect/Context";
+import * as effect_Types6 from "effect/Types";
+import * as effect_Cause6 from "effect/Cause";
+
+//#region src/MimicDataStorage.d.ts
+declare namespace MimicDataStorage_d_exports {
+  export { MimicDataStorage, MimicDataStorageTag, StorageDeleteError, StorageError, StorageLoadError, StorageSaveError, layer, layerEffect, make };
+}
+declare const StorageLoadError_base: new <A extends Record<string, any> = {}>(args: effect_Types6.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause6.YieldableError & {
+  readonly _tag: "StorageLoadError";
+} & Readonly<A>;
+/**
+ * Error when loading a document from storage fails.
+ */
+declare class StorageLoadError extends StorageLoadError_base<{
+  readonly documentId: string;
+  readonly cause: unknown;
+}> {
+  get message(): string;
+}
+declare const StorageSaveError_base: new <A extends Record<string, any> = {}>(args: effect_Types6.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause6.YieldableError & {
+  readonly _tag: "StorageSaveError";
+} & Readonly<A>;
+/**
+ * Error when saving a document to storage fails.
+ */
+declare class StorageSaveError extends StorageSaveError_base<{
+  readonly documentId: string;
+  readonly cause: unknown;
+}> {
+  get message(): string;
+}
+declare const StorageDeleteError_base: new <A extends Record<string, any> = {}>(args: effect_Types6.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause6.YieldableError & {
+  readonly _tag: "StorageDeleteError";
+} & Readonly<A>;
+/**
+ * Error when deleting a document from storage fails.
+ */
+declare class StorageDeleteError extends StorageDeleteError_base<{
+  readonly documentId: string;
+  readonly cause: unknown;
+}> {
+  get message(): string;
+}
+/**
+ * Union of all storage errors.
+ */
+type StorageError = StorageLoadError | StorageSaveError | StorageDeleteError;
+/**
+ * Data storage service interface.
+ * Implementations can persist documents to various backends (memory, S3, database, etc.)
+ */
+interface MimicDataStorage {
+  /**
+   * Load a document's state from storage.
+   * @param documentId - The unique identifier for the document
+   * @returns The document state, or undefined if not found
+   */
+  readonly load: (documentId: string) => Effect.Effect<unknown | undefined, StorageLoadError>;
+  /**
+   * Save a document's state to storage.
+   * @param documentId - The unique identifier for the document
+   * @param state - The document state to persist
+   */
+  readonly save: (documentId: string, state: unknown) => Effect.Effect<void, StorageSaveError>;
+  /**
+   * Delete a document from storage.
+   * @param documentId - The unique identifier for the document
+   */
+  readonly delete: (documentId: string) => Effect.Effect<void, StorageDeleteError>;
+  /**
+   * Transform data after loading from storage.
+   * Useful for migrations, decryption, decompression, etc.
+   * @param state - The raw state loaded from storage
+   * @returns The transformed state
+   */
+  readonly onLoad: (state: unknown) => Effect.Effect<unknown>;
+  /**
+   * Transform/validate data before saving to storage.
+   * Useful for encryption, compression, validation, etc.
+   * @param state - The state to be saved
+   * @returns The transformed state
+   */
+  readonly onSave: (state: unknown) => Effect.Effect<unknown>;
+}
+declare const MimicDataStorageTag_base: Context.TagClass<MimicDataStorageTag, "@voidhash/mimic-server-effect/MimicDataStorage", MimicDataStorage>;
+/**
+ * Context tag for MimicDataStorage service.
+ */
+declare class MimicDataStorageTag extends MimicDataStorageTag_base {}
+/**
+ * Create a MimicDataStorage layer from a storage implementation.
+ */
+declare const layer: (storage: MimicDataStorage) => Layer.Layer<MimicDataStorageTag>;
+/**
+ * Create a MimicDataStorage layer from an Effect that produces a storage implementation.
+ */
+declare const layerEffect: <E, R>(effect: Effect.Effect<MimicDataStorage, E, R>) => Layer.Layer<MimicDataStorageTag, E, R>;
+/**
+ * Create a simple storage implementation with minimal configuration.
+ */
+declare const make: (options: {
+  readonly load: (documentId: string) => Effect.Effect<unknown | undefined, StorageLoadError>;
+  readonly save: (documentId: string, state: unknown) => Effect.Effect<void, StorageSaveError>;
+  readonly delete?: (documentId: string) => Effect.Effect<void, StorageDeleteError>;
+  readonly onLoad?: (state: unknown) => Effect.Effect<unknown>;
+  readonly onSave?: (state: unknown) => Effect.Effect<unknown>;
+}) => MimicDataStorage;
+//#endregion
+export { MimicDataStorageTag, MimicDataStorage_d_exports };
+//# sourceMappingURL=MimicDataStorage.d.cts.map

package/dist/MimicDataStorage.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MimicDataStorage.d.cts","names":[],"sources":["../src/MimicDataStorage.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;cAOsC;;;;;;cAUzB,gBAAA,SAAyB;;;;;AAVA;cAiBrC;;;;;;cAKY,gBAAA,SAAyB;;;;;;AAZtC,cAmBC,uBAnBqC,EAAA,IAAA,CAAA,gBAAA,CAAA,MAAA,EAAA,GAAA,CAAA,GAAA,CAAA,CAAA,CAAA,CAAA,IAAA,sBAAA,EAAA,EAAA,CAAA,CAAA,CAAA,SAAA,IAAA,GAAA,IAAA,GAAA,iBAAA,OAAA,KAAA,SAAA,MAAA,GAAA,KAAA,IAAA,IAAA,EAAA,CAAA,EAAA,EAAA,kCAAA;EAOrC,SAAA,IAAA,EAAA,oBAAA;;;;;cAiBY,kBAAA,SAA2B;;;;;;;;AAZxC;AAOC,KAiBW,YAAA,GAAe,gBAjB1B,GAiB6C,gBAjB7C,GAiBgE,kBAjBhE;;;;;UA2BgB,gBAAA;;;;;;yCAQV,MAAA,CAAO,4BAA4B;;AA9B1C;AAYA;;;EAAiE,SAAA,IAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,KAAA,EAAA,OAAA,EAAA,GA4B1D,MAAA,CAAO,MA5BmD,CAAA,IAAA,EA4BtC,gBA5BsC,CAAA;EAAkB;AAUnF;;;EAkB2B,SAAA,MAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,GAQpB,MAAA,CAAO,MARa,CAAA,IAAA,EAQA,kBARA,CAAA;EAApB;;;;;;EAyBN,SAAA,MAAA,EAAA,CAAA,KAAA,EAAA,OAAA,EAAA,GATsC,MAAA,CAAO,MAS7C,CAAA,OAAA,CAAA;;;;;AASD;AAWA;EAA+B,SAAA,MAAA,EAAA,CAAA,KAAA,EAAA,OAAA,EAAA,GArBQ,MAAA,CAAO,MAqBf,CAAA,OAAA,CAAA;;cApB9B,wBAoBuD,kBAAA,oBAAA,EAAA,gDAAA,kBAAA,CAAA;;AAMxD;;AAC0C,cAlB7B,mBAAA,SAA4B,wBAAA,CAkBC;;;;AACH,cAR1B,KAQ0B,EAAA,CAAA,OAAA,EARR,gBAQQ,EAAA,GARW,KAAA,CAAM,KAQjB,CARuB,mBAQvB,CAAA;;;AAUvC;AAC4E,cAb/D,WAa+D,EAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,MAAA,EAZlE,MAAA,CAAO,MAY2D,CAZpD,gBAYoD,EAZlC,CAYkC,EAZ/B,CAY+B,CAAA,EAAA,GAXzE,KAAA,CAAM,KAWmE,CAX7D,mBAW6D,EAXxC,CAWwC,EAXrC,CAWqC,CAAA;;;;AAEZ,cAHnD,IAGmD,EAAA,CAAA,OAAA,EAAA;EAApB,SAAO,IAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,GAFV,MAAA,CAAO,MAEG,CAAA,OAAA,GAAA,SAAA,EAFyB,gBAEzB,CAAA;EACX,SAAO,IAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,KAAA,EAAA,OAAA,EAAA,GAFU,MAAA,CAAO,MAEjB,CAAA,IAAA,EAF8B,gBAE9B,CAAA;EACP,SAAO,MAAA,CAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,GAFH,MAAA,CAAO,MAEJ,CAAA,IAAA,EAFiB,kBAEjB,CAAA;EAC3C,SAAA,MAAA,CAAA,EAAA,CAAA,KAAA,EAAA,OAAA,EAAA,GAFoC,MAAA,CAAO,MAE3C,CAAA,OAAA,CAAA;EAMF,SAAA,MAAA,CAAA,EAAA,CAAA,KAAA,EAAA,OAAA,EAAA,GAPsC,MAAA,CAAO,MAO7C,CAAA,OAAA,CAAA;MANE"}

package/dist/MimicDataStorage.d.mts

@@ -0,0 +1,113 @@
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Context from "effect/Context";
+import * as effect_Types6 from "effect/Types";
+import * as effect_Cause6 from "effect/Cause";
+
+//#region src/MimicDataStorage.d.ts
+declare namespace MimicDataStorage_d_exports {
+  export { MimicDataStorage, MimicDataStorageTag, StorageDeleteError, StorageError, StorageLoadError, StorageSaveError, layer, layerEffect, make };
+}
+declare const StorageLoadError_base: new <A extends Record<string, any> = {}>(args: effect_Types6.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause6.YieldableError & {
+  readonly _tag: "StorageLoadError";
+} & Readonly<A>;
+/**
+ * Error when loading a document from storage fails.
+ */
+declare class StorageLoadError extends StorageLoadError_base<{
+  readonly documentId: string;
+  readonly cause: unknown;
+}> {
+  get message(): string;
+}
+declare const StorageSaveError_base: new <A extends Record<string, any> = {}>(args: effect_Types6.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause6.YieldableError & {
+  readonly _tag: "StorageSaveError";
+} & Readonly<A>;
+/**
+ * Error when saving a document to storage fails.
+ */
+declare class StorageSaveError extends StorageSaveError_base<{
+  readonly documentId: string;
+  readonly cause: unknown;
+}> {
+  get message(): string;
+}
+declare const StorageDeleteError_base: new <A extends Record<string, any> = {}>(args: effect_Types6.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause6.YieldableError & {
+  readonly _tag: "StorageDeleteError";
+} & Readonly<A>;
+/**
+ * Error when deleting a document from storage fails.
+ */
+declare class StorageDeleteError extends StorageDeleteError_base<{
+  readonly documentId: string;
+  readonly cause: unknown;
+}> {
+  get message(): string;
+}
+/**
+ * Union of all storage errors.
+ */
+type StorageError = StorageLoadError | StorageSaveError | StorageDeleteError;
+/**
+ * Data storage service interface.
+ * Implementations can persist documents to various backends (memory, S3, database, etc.)
+ */
+interface MimicDataStorage {
+  /**
+   * Load a document's state from storage.
+   * @param documentId - The unique identifier for the document
+   * @returns The document state, or undefined if not found
+   */
+  readonly load: (documentId: string) => Effect.Effect<unknown | undefined, StorageLoadError>;
+  /**
+   * Save a document's state to storage.
+   * @param documentId - The unique identifier for the document
+   * @param state - The document state to persist
+   */
+  readonly save: (documentId: string, state: unknown) => Effect.Effect<void, StorageSaveError>;
+  /**
+   * Delete a document from storage.
+   * @param documentId - The unique identifier for the document
+   */
+  readonly delete: (documentId: string) => Effect.Effect<void, StorageDeleteError>;
+  /**
+   * Transform data after loading from storage.
+   * Useful for migrations, decryption, decompression, etc.
+   * @param state - The raw state loaded from storage
+   * @returns The transformed state
+   */
+  readonly onLoad: (state: unknown) => Effect.Effect<unknown>;
+  /**
+   * Transform/validate data before saving to storage.
+   * Useful for encryption, compression, validation, etc.
+   * @param state - The state to be saved
+   * @returns The transformed state
+   */
+  readonly onSave: (state: unknown) => Effect.Effect<unknown>;
+}
+declare const MimicDataStorageTag_base: Context.TagClass<MimicDataStorageTag, "@voidhash/mimic-server-effect/MimicDataStorage", MimicDataStorage>;
+/**
+ * Context tag for MimicDataStorage service.
+ */
+declare class MimicDataStorageTag extends MimicDataStorageTag_base {}
+/**
+ * Create a MimicDataStorage layer from a storage implementation.
+ */
+declare const layer: (storage: MimicDataStorage) => Layer.Layer<MimicDataStorageTag>;
+/**
+ * Create a MimicDataStorage layer from an Effect that produces a storage implementation.
+ */
+declare const layerEffect: <E, R>(effect: Effect.Effect<MimicDataStorage, E, R>) => Layer.Layer<MimicDataStorageTag, E, R>;
+/**
+ * Create a simple storage implementation with minimal configuration.
+ */
+declare const make: (options: {
+  readonly load: (documentId: string) => Effect.Effect<unknown | undefined, StorageLoadError>;
+  readonly save: (documentId: string, state: unknown) => Effect.Effect<void, StorageSaveError>;
+  readonly delete?: (documentId: string) => Effect.Effect<void, StorageDeleteError>;
+  readonly onLoad?: (state: unknown) => Effect.Effect<unknown>;
+  readonly onSave?: (state: unknown) => Effect.Effect<unknown>;
+}) => MimicDataStorage;
+//#endregion
+export { MimicDataStorageTag, MimicDataStorage_d_exports };
+//# sourceMappingURL=MimicDataStorage.d.mts.map

package/dist/MimicDataStorage.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MimicDataStorage.d.mts","names":[],"sources":["../src/MimicDataStorage.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;cAOsC;;;;;;cAUzB,gBAAA,SAAyB;;;;;AAVA;cAiBrC;;;;;;cAKY,gBAAA,SAAyB;;;;;;AAZtC,cAmBC,uBAnBqC,EAAA,IAAA,CAAA,gBAAA,CAAA,MAAA,EAAA,GAAA,CAAA,GAAA,CAAA,CAAA,CAAA,CAAA,IAAA,sBAAA,EAAA,EAAA,CAAA,CAAA,CAAA,SAAA,IAAA,GAAA,IAAA,GAAA,iBAAA,OAAA,KAAA,SAAA,MAAA,GAAA,KAAA,IAAA,IAAA,EAAA,CAAA,EAAA,EAAA,kCAAA;EAOrC,SAAA,IAAA,EAAA,oBAAA;;;;;cAiBY,kBAAA,SAA2B;;;;;;;;AAZxC;AAOC,KAiBW,YAAA,GAAe,gBAjB1B,GAiB6C,gBAjB7C,GAiBgE,kBAjBhE;;;;;UA2BgB,gBAAA;;;;;;yCAQV,MAAA,CAAO,4BAA4B;;AA9B1C;AAYA;;;EAAiE,SAAA,IAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,KAAA,EAAA,OAAA,EAAA,GA4B1D,MAAA,CAAO,MA5BmD,CAAA,IAAA,EA4BtC,gBA5BsC,CAAA;EAAkB;AAUnF;;;EAkB2B,SAAA,MAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,GAQpB,MAAA,CAAO,MARa,CAAA,IAAA,EAQA,kBARA,CAAA;EAApB;;;;;;EAyBN,SAAA,MAAA,EAAA,CAAA,KAAA,EAAA,OAAA,EAAA,GATsC,MAAA,CAAO,MAS7C,CAAA,OAAA,CAAA;;;;;AASD;AAWA;EAA+B,SAAA,MAAA,EAAA,CAAA,KAAA,EAAA,OAAA,EAAA,GArBQ,MAAA,CAAO,MAqBf,CAAA,OAAA,CAAA;;cApB9B,wBAoBuD,kBAAA,oBAAA,EAAA,gDAAA,kBAAA,CAAA;;AAMxD;;AAC0C,cAlB7B,mBAAA,SAA4B,wBAAA,CAkBC;;;;AACH,cAR1B,KAQ0B,EAAA,CAAA,OAAA,EARR,gBAQQ,EAAA,GARW,KAAA,CAAM,KAQjB,CARuB,mBAQvB,CAAA;;;AAUvC;AAC4E,cAb/D,WAa+D,EAAA,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,MAAA,EAZlE,MAAA,CAAO,MAY2D,CAZpD,gBAYoD,EAZlC,CAYkC,EAZ/B,CAY+B,CAAA,EAAA,GAXzE,KAAA,CAAM,KAWmE,CAX7D,mBAW6D,EAXxC,CAWwC,EAXrC,CAWqC,CAAA;;;;AAEZ,cAHnD,IAGmD,EAAA,CAAA,OAAA,EAAA;EAApB,SAAO,IAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,GAFV,MAAA,CAAO,MAEG,CAAA,OAAA,GAAA,SAAA,EAFyB,gBAEzB,CAAA;EACX,SAAO,IAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,KAAA,EAAA,OAAA,EAAA,GAFU,MAAA,CAAO,MAEjB,CAAA,IAAA,EAF8B,gBAE9B,CAAA;EACP,SAAO,MAAA,CAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,GAFH,MAAA,CAAO,MAEJ,CAAA,IAAA,EAFiB,kBAEjB,CAAA;EAC3C,SAAA,MAAA,CAAA,EAAA,CAAA,KAAA,EAAA,OAAA,EAAA,GAFoC,MAAA,CAAO,MAE3C,CAAA,OAAA,CAAA;EAMF,SAAA,MAAA,CAAA,EAAA,CAAA,KAAA,EAAA,OAAA,EAAA,GAPsC,MAAA,CAAO,MAO7C,CAAA,OAAA,CAAA;MANE"}

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