@voidhash/mimic-effect 0.0.9 → 1.0.0-beta.2

package/README.md

@@ -0,0 +1,385 @@
+# @voidhash/mimic-effect
+
+Effect-based server engine for real-time document collaboration using the Mimic CRDT system.
+
+## Installation
+
+```bash
+pnpm add @voidhash/mimic-effect @voidhash/mimic effect @effect/platform
+```
+
+## Quick Start
+
+```typescript
+import { Effect, Layer } from "effect"
+import { Primitive } from "@voidhash/mimic"
+import {
+  MimicServerEngine,
+  ColdStorage,
+  HotStorage,
+  MimicAuthService,
+} from "@voidhash/mimic-effect"
+
+// Define your document schema
+const TodoSchema = Primitive.Struct({
+  title: Primitive.String().default(""),
+  items: Primitive.Array(
+    Primitive.Struct({
+      text: Primitive.String(),
+      completed: Primitive.Boolean().default(false),
+    })
+  ).default([]),
+})
+
+// Create the engine
+const Engine = MimicServerEngine.make({
+  schema: TodoSchema,
+  initial: { title: "My Todo List" },
+  basePath: "/mimic",
+})
+
+// Wire up with storage and auth
+const MimicLive = Engine.pipe(
+  Layer.provide(ColdStorage.InMemory.make()),
+  Layer.provide(HotStorage.InMemory.make()),
+  Layer.provide(MimicAuthService.NoAuth.make())
+)
+
+// Use in your HTTP server
+const program = Effect.gen(function* () {
+  const engine = yield* MimicServerEngine.Tag
+  // Mount engine.routes in your HTTP server
+  // e.g., with @effect/platform-bun or @effect/platform-node
+})
+
+program.pipe(Effect.provide(MimicLive), Effect.runPromise)
+```
+
+## Architecture
+
+```
+                        MimicServerEngine
+                              |
+          +-------------------+-------------------+
+          |                   |                   |
+    ColdStorage         HotStorage        MimicAuthService
+    (Snapshots)           (WAL)           (Auth/Permissions)
+          |                   |
+          +-------------------+
+                    |
+            Document Storage
+```
+
+### Components
+
+- **MimicServerEngine**: Main entry point that creates HTTP routes for WebSocket connections
+- **ColdStorage**: Snapshot storage interface (for persisting document state)
+- **HotStorage**: Write-ahead log storage (for transaction history)
+- **MimicAuthService**: Authentication and authorization service
+- **DocumentManager**: Internal service managing document lifecycle
+- **PresenceManager**: Internal service managing ephemeral presence state
+
+## Configuration
+
+```typescript
+const Engine = MimicServerEngine.make({
+  // Required: Document schema
+  schema: MySchema,
+
+  // Optional: Initial state for new documents
+  initial: { title: "Untitled" },
+  // Or a function for dynamic initial state:
+  // initial: ({ documentId }) => Effect.succeed({ title: documentId }),
+
+  // Optional: Presence schema for cursor tracking, etc.
+  presence: CursorPresence,
+
+  // Optional: WebSocket route base path (default: "/mimic")
+  basePath: "/mimic",
+
+  // Optional: Document idle timeout before GC (default: 5 minutes)
+  maxIdleTime: "10 minutes",
+
+  // Optional: Max transaction history for deduplication (default: 1000)
+  maxTransactionHistory: 500,
+
+  // Optional: Snapshot configuration
+  snapshot: {
+    interval: "5 minutes",           // Time-based snapshot interval
+    transactionThreshold: 100,       // Transaction count threshold
+  },
+
+  // Optional: Heartbeat configuration
+  heartbeatInterval: "30 seconds",   // How often to ping
+  heartbeatTimeout: "10 seconds",    // How long to wait for pong
+})
+```
+
+## Storage Implementations
+
+### In-Memory (Development/Testing)
+
+```typescript
+import { ColdStorage, HotStorage } from "@voidhash/mimic-effect"
+
+const StorageLive = Layer.mergeAll(
+  ColdStorage.InMemory.make(),
+  HotStorage.InMemory.make()
+)
+```
+
+### Custom Storage
+
+```typescript
+import { ColdStorage, HotStorage } from "@voidhash/mimic-effect"
+
+// Implement ColdStorage interface
+const PostgresColdStorage = Layer.effect(
+  ColdStorage.Tag,
+  Effect.gen(function* () {
+    const db = yield* DatabaseService
+    return {
+      load: (documentId) => /* load from DB */,
+      save: (documentId, doc) => /* save to DB */,
+      delete: (documentId) => /* delete from DB */,
+    }
+  })
+)
+
+// Implement HotStorage interface
+const RedisHotStorage = Layer.effect(
+  HotStorage.Tag,
+  Effect.gen(function* () {
+    const redis = yield* RedisService
+    return {
+      getEntries: (documentId, sinceVersion) => /* get from Redis */,
+      append: (documentId, entry) => /* append to Redis */,
+      truncate: (documentId, upToVersion) => /* truncate in Redis */,
+    }
+  })
+)
+```
+
+## Authentication
+
+### No Authentication (Development)
+
+```typescript
+import { MimicAuthService } from "@voidhash/mimic-effect"
+
+const AuthLive = MimicAuthService.NoAuth.make()
+// All users get "write" permission as "anonymous"
+```
+
+### Static Permissions
+
+```typescript
+import { MimicAuthService } from "@voidhash/mimic-effect"
+
+const AuthLive = MimicAuthService.Static.make({
+  permissions: {
+    "admin-token": "write",
+    "viewer-token": "read",
+  },
+  defaultPermission: "read", // Optional fallback
+})
+```
+
+### Custom Authentication
+
+```typescript
+import { MimicAuthService, AuthenticationError } from "@voidhash/mimic-effect"
+
+const CustomAuth = MimicAuthService.make(
+  Effect.gen(function* () {
+    const jwt = yield* JwtService
+    const db = yield* DatabaseService
+
+    return {
+      authenticate: (token, documentId) =>
+        Effect.gen(function* () {
+          // Verify JWT
+          const payload = yield* jwt.verify(token).pipe(
+            Effect.mapError(() => new AuthenticationError({ reason: "Invalid token" }))
+          )
+
+          // Check document permissions
+          const permission = yield* db.getDocumentPermission(
+            payload.userId,
+            documentId
+          )
+
+          return {
+            userId: payload.userId,
+            permission, // "read" or "write"
+          }
+        }),
+    }
+  })
+)
+```
+
+### Permissions
+
+- `"read"`: Can subscribe, receive transactions, get snapshots
+- `"write"`: All of the above, plus can submit transactions and set presence
+
+## Presence
+
+Enable presence tracking for features like cursor position, user status, etc.
+
+```typescript
+import { Schema } from "effect"
+import { Presence } from "@voidhash/mimic"
+
+// Define presence schema
+const CursorPresence = Presence.make({
+  schema: Schema.Struct({
+    x: Schema.Number,
+    y: Schema.Number,
+    color: Schema.String,
+    name: Schema.optional(Schema.String),
+  }),
+})
+
+// Enable in engine config
+const Engine = MimicServerEngine.make({
+  schema: DocSchema,
+  presence: CursorPresence,
+})
+```
+
+## WebSocket Protocol
+
+### Client -> Server Messages
+
+```typescript
+// Authentication
+{ type: "auth", token: "user-token" }
+
+// Heartbeat
+{ type: "ping" }
+
+// Submit transaction
+{ type: "submit", transaction: EncodedTransaction }
+
+// Request snapshot
+{ type: "request_snapshot" }
+
+// Set presence
+{ type: "presence_set", data: { x: 100, y: 200 } }
+
+// Clear presence
+{ type: "presence_clear" }
+```
+
+### Server -> Client Messages
+
+```typescript
+// Authentication result
+{ type: "auth_result", success: true, userId: "...", permission: "write" }
+{ type: "auth_result", success: false, error: "Invalid token" }
+
+// Heartbeat response
+{ type: "pong" }
+
+// Document snapshot
+{ type: "snapshot", state: {...}, version: 42 }
+
+// Transaction broadcast
+{ type: "transaction", transaction: EncodedTransaction, version: 43 }
+
+// Transaction error
+{ type: "error", transactionId: "tx-123", reason: "..." }
+
+// Presence snapshot (after auth)
+{ type: "presence_snapshot", selfId: "conn-123", presences: {...} }
+
+// Presence update
+{ type: "presence_update", entries: { "conn-456": { data: {...}, userId: "..." } } }
+
+// Presence removal
+{ type: "presence_remove", connectionId: "conn-456" }
+```
+
+## Metrics
+
+Built-in observability metrics using Effect's Metric API:
+
+```typescript
+import { MimicMetrics } from "@voidhash/mimic-effect"
+
+// Connection metrics
+MimicMetrics.connectionsActive    // Gauge: Current connections
+MimicMetrics.connectionsTotal     // Counter: Total connections
+MimicMetrics.connectionsDuration  // Histogram: Connection duration (ms)
+MimicMetrics.connectionsErrors    // Counter: Connection errors
+
+// Document metrics
+MimicMetrics.documentsActive      // Gauge: Documents in memory
+MimicMetrics.documentsCreated     // Counter: New documents
+MimicMetrics.documentsRestored    // Counter: Restored from storage
+MimicMetrics.documentsEvicted     // Counter: Evicted (idle GC)
+
+// Transaction metrics
+MimicMetrics.transactionsProcessed // Counter: Successful transactions
+MimicMetrics.transactionsRejected  // Counter: Rejected transactions
+MimicMetrics.transactionsLatency   // Histogram: Processing time (ms)
+
+// Storage metrics
+MimicMetrics.storageSnapshots      // Counter: Snapshots saved
+MimicMetrics.storageSnapshotLatency // Histogram: Snapshot save time (ms)
+MimicMetrics.storageWalAppends     // Counter: WAL entries written
+
+// Presence metrics
+MimicMetrics.presenceUpdates       // Counter: Presence updates
+MimicMetrics.presenceActive        // Gauge: Active presences
+```
+
+## Integration Examples
+
+### With @effect/platform-bun
+
+```typescript
+import { BunHttpServer, BunRuntime } from "@effect/platform-bun"
+import { HttpRouter, HttpServer } from "@effect/platform"
+
+const server = HttpServer.serve(engine.routes).pipe(
+  Layer.provide(MimicLive),
+  Layer.provide(BunHttpServer.layer({ port: 3000 }))
+)
+
+BunRuntime.runMain(Layer.launch(server))
+```
+
+### With @effect/platform-node
+
+```typescript
+import { NodeHttpServer, NodeRuntime } from "@effect/platform-node"
+import { HttpRouter, HttpServer } from "@effect/platform"
+
+const server = HttpServer.serve(engine.routes).pipe(
+  Layer.provide(MimicLive),
+  Layer.provide(NodeHttpServer.layer({ port: 3000 }))
+)
+
+NodeRuntime.runMain(Layer.launch(server))
+```
+
+## Error Types
+
+```typescript
+import {
+  ColdStorageError,
+  HotStorageError,
+  AuthenticationError,
+  AuthorizationError,
+  MissingDocumentIdError,
+  MessageParseError,
+  TransactionRejectedError,
+} from "@voidhash/mimic-effect"
+```
+
+## License
+
+MIT

package/dist/ColdStorage.cjs

@@ -0,0 +1,60 @@
+let effect = require("effect");
+
+//#region src/ColdStorage.ts
+/**
+* @voidhash/mimic-effect - ColdStorage
+*
+* Interface and implementations for document snapshot storage.
+*/
+/**
+* Context tag for ColdStorage service
+*/
+var ColdStorageTag = class extends effect.Context.Tag("@voidhash/mimic-effect/ColdStorage")() {};
+/**
+* Create a ColdStorage layer from an Effect that produces a ColdStorage service.
+*
+* This allows you to access other Effect services when implementing custom storage.
+*
+* @example
+* ```typescript
+* const Cold = ColdStorage.make(
+*   Effect.gen(function*() {
+*     const redis = yield* RedisService
+*
+*     return {
+*       load: (documentId) => redis.get(`doc:${documentId}`).pipe(
+*         Effect.map(data => data ? JSON.parse(data) : undefined)
+*       ),
+*       save: (documentId, document) =>
+*         redis.set(`doc:${documentId}`, JSON.stringify(document)),
+*       delete: (documentId) => redis.del(`doc:${documentId}`),
+*     }
+*   })
+* )
+* ```
+*/
+const make = (effect$1) => effect.Layer.effect(ColdStorageTag, effect$1);
+let InMemory;
+(function(_InMemory) {
+	_InMemory.make = () => effect.Layer.effect(ColdStorageTag, effect.Effect.gen(function* () {
+		const store = yield* effect.Ref.make(effect.HashMap.empty());
+		return {
+			load: (documentId) => effect.Effect.gen(function* () {
+				const current = yield* effect.Ref.get(store);
+				const result = effect.HashMap.get(current, documentId);
+				return result._tag === "Some" ? result.value : void 0;
+			}),
+			save: (documentId, document) => effect.Ref.update(store, (map) => effect.HashMap.set(map, documentId, document)),
+			delete: (documentId) => effect.Ref.update(store, (map) => effect.HashMap.remove(map, documentId))
+		};
+	}));
+})(InMemory || (InMemory = {}));
+const ColdStorage = {
+	Tag: ColdStorageTag,
+	make,
+	InMemory
+};
+
+//#endregion
+exports.ColdStorage = ColdStorage;
+exports.ColdStorageTag = ColdStorageTag;

package/dist/ColdStorage.d.cts

@@ -0,0 +1,53 @@
+import { StoredDocument } from "./Types.cjs";
+import { ColdStorageError } from "./Errors.cjs";
+import { Context, Effect, Layer } from "effect";
+
+//#region src/ColdStorage.d.ts
+
+/**
+ * ColdStorage interface for storing document snapshots.
+ *
+ * This is the "cold" tier of the two-tier storage system.
+ * It stores complete document snapshots less frequently (on periodic intervals
+ * or after a threshold of transactions).
+ */
+interface ColdStorage {
+  /**
+   * Load a document snapshot.
+   * Returns undefined if the document doesn't exist.
+   */
+  readonly load: (documentId: string) => Effect.Effect<StoredDocument | undefined, ColdStorageError>;
+  /**
+   * Save a document snapshot.
+   */
+  readonly save: (documentId: string, document: StoredDocument) => Effect.Effect<void, ColdStorageError>;
+  /**
+   * Delete a document snapshot.
+   */
+  readonly delete: (documentId: string) => Effect.Effect<void, ColdStorageError>;
+}
+declare const ColdStorageTag_base: Context.TagClass<ColdStorageTag, "@voidhash/mimic-effect/ColdStorage", ColdStorage>;
+/**
+ * Context tag for ColdStorage service
+ */
+declare class ColdStorageTag extends ColdStorageTag_base {}
+/**
+ * In-memory ColdStorage implementation.
+ *
+ * Useful for testing and development. Not suitable for production
+ * as data is lost when the process restarts.
+ */
+declare namespace InMemory {
+  /**
+   * Create an in-memory ColdStorage layer.
+   */
+  const make: () => Layer.Layer<ColdStorageTag>;
+}
+declare const ColdStorage: {
+  Tag: typeof ColdStorageTag;
+  make: <E, R>(effect: Effect.Effect<ColdStorage, E, R>) => Layer.Layer<ColdStorageTag, E, R>;
+  InMemory: typeof InMemory;
+};
+//#endregion
+export { ColdStorage, ColdStorageTag };
+//# sourceMappingURL=ColdStorage.d.cts.map

package/dist/ColdStorage.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColdStorage.d.cts","names":[],"sources":["../src/ColdStorage.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;AA2CC,UAvBgB,WAAA,CAuBhB;;;;;EASY,SAAA,IAAA,EAAA,CAAA,UAAe,EAAA,MAAQ,EAAA,GAzB7B,MAAA,CAAO,MA4BX,CA5BkB,cA4BlB,GAAA,SAAA,EA5B8C,gBA4B9C,CAAA;EA4Cc;AAgCjB;;EA9CwB,SAAA,IAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,QAAA,EAnDV,cAmDU,EAAA,GAlDjB,MAAA,CAAO,MAkDU,CAAA,IAAA,EAlDG,gBAkDH,CAAA;EAAa;;;EACtB,SAAA,MAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,GA5CR,MAAA,CAAO,MA4CC,CAAA,IAAA,EA5CY,gBA4CZ,CAAA;;cA3Cd,mBA2CiC,kBAAA,eAAA,EAAA,oCAAA,aAAA,CAAA;;;;cAlCrB,cAAA,SAAuB,mBAAA;;;;;;;kBA+CnB,QAAA;;;;oBAIS,KAAA,CAAM,MAAM;;cA4BzB;;uBA9CH,MAAA,CAAO,OAAO,aAAa,GAAG,OACrC,KAAA,CAAM,MAAM,gBAAgB,GAAG"}

package/dist/ColdStorage.d.mts

@@ -0,0 +1,53 @@
+import { StoredDocument } from "./Types.mjs";
+import { ColdStorageError } from "./Errors.mjs";
+import { Context, Effect, Layer } from "effect";
+
+//#region src/ColdStorage.d.ts
+
+/**
+ * ColdStorage interface for storing document snapshots.
+ *
+ * This is the "cold" tier of the two-tier storage system.
+ * It stores complete document snapshots less frequently (on periodic intervals
+ * or after a threshold of transactions).
+ */
+interface ColdStorage {
+  /**
+   * Load a document snapshot.
+   * Returns undefined if the document doesn't exist.
+   */
+  readonly load: (documentId: string) => Effect.Effect<StoredDocument | undefined, ColdStorageError>;
+  /**
+   * Save a document snapshot.
+   */
+  readonly save: (documentId: string, document: StoredDocument) => Effect.Effect<void, ColdStorageError>;
+  /**
+   * Delete a document snapshot.
+   */
+  readonly delete: (documentId: string) => Effect.Effect<void, ColdStorageError>;
+}
+declare const ColdStorageTag_base: Context.TagClass<ColdStorageTag, "@voidhash/mimic-effect/ColdStorage", ColdStorage>;
+/**
+ * Context tag for ColdStorage service
+ */
+declare class ColdStorageTag extends ColdStorageTag_base {}
+/**
+ * In-memory ColdStorage implementation.
+ *
+ * Useful for testing and development. Not suitable for production
+ * as data is lost when the process restarts.
+ */
+declare namespace InMemory {
+  /**
+   * Create an in-memory ColdStorage layer.
+   */
+  const make: () => Layer.Layer<ColdStorageTag>;
+}
+declare const ColdStorage: {
+  Tag: typeof ColdStorageTag;
+  make: <E, R>(effect: Effect.Effect<ColdStorage, E, R>) => Layer.Layer<ColdStorageTag, E, R>;
+  InMemory: typeof InMemory;
+};
+//#endregion
+export { ColdStorage, ColdStorageTag };
+//# sourceMappingURL=ColdStorage.d.mts.map

package/dist/ColdStorage.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColdStorage.d.mts","names":[],"sources":["../src/ColdStorage.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;AA2CC,UAvBgB,WAAA,CAuBhB;;;;;EASY,SAAA,IAAA,EAAA,CAAA,UAAe,EAAA,MAAQ,EAAA,GAzB7B,MAAA,CAAO,MA4BX,CA5BkB,cA4BlB,GAAA,SAAA,EA5B8C,gBA4B9C,CAAA;EA4Cc;AAgCjB;;EA9CwB,SAAA,IAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,QAAA,EAnDV,cAmDU,EAAA,GAlDjB,MAAA,CAAO,MAkDU,CAAA,IAAA,EAlDG,gBAkDH,CAAA;EAAa;;;EACtB,SAAA,MAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,GA5CR,MAAA,CAAO,MA4CC,CAAA,IAAA,EA5CY,gBA4CZ,CAAA;;cA3Cd,mBA2CiC,kBAAA,eAAA,EAAA,oCAAA,aAAA,CAAA;;;;cAlCrB,cAAA,SAAuB,mBAAA;;;;;;;kBA+CnB,QAAA;;;;oBAIS,KAAA,CAAM,MAAM;;cA4BzB;;uBA9CH,MAAA,CAAO,OAAO,aAAa,GAAG,OACrC,KAAA,CAAM,MAAM,gBAAgB,GAAG"}

package/dist/ColdStorage.mjs

@@ -0,0 +1,60 @@
+import { Context, Effect, HashMap, Layer, Ref } from "effect";
+
+//#region src/ColdStorage.ts
+/**
+* @voidhash/mimic-effect - ColdStorage
+*
+* Interface and implementations for document snapshot storage.
+*/
+/**
+* Context tag for ColdStorage service
+*/
+var ColdStorageTag = class extends Context.Tag("@voidhash/mimic-effect/ColdStorage")() {};
+/**
+* Create a ColdStorage layer from an Effect that produces a ColdStorage service.
+*
+* This allows you to access other Effect services when implementing custom storage.
+*
+* @example
+* ```typescript
+* const Cold = ColdStorage.make(
+*   Effect.gen(function*() {
+*     const redis = yield* RedisService
+*
+*     return {
+*       load: (documentId) => redis.get(`doc:${documentId}`).pipe(
+*         Effect.map(data => data ? JSON.parse(data) : undefined)
+*       ),
+*       save: (documentId, document) =>
+*         redis.set(`doc:${documentId}`, JSON.stringify(document)),
+*       delete: (documentId) => redis.del(`doc:${documentId}`),
+*     }
+*   })
+* )
+* ```
+*/
+const make = (effect) => Layer.effect(ColdStorageTag, effect);
+let InMemory;
+(function(_InMemory) {
+	_InMemory.make = () => Layer.effect(ColdStorageTag, Effect.gen(function* () {
+		const store = yield* Ref.make(HashMap.empty());
+		return {
+			load: (documentId) => Effect.gen(function* () {
+				const current = yield* Ref.get(store);
+				const result = HashMap.get(current, documentId);
+				return result._tag === "Some" ? result.value : void 0;
+			}),
+			save: (documentId, document) => Ref.update(store, (map) => HashMap.set(map, documentId, document)),
+			delete: (documentId) => Ref.update(store, (map) => HashMap.remove(map, documentId))
+		};
+	}));
+})(InMemory || (InMemory = {}));
+const ColdStorage = {
+	Tag: ColdStorageTag,
+	make,
+	InMemory
+};
+
+//#endregion
+export { ColdStorage, ColdStorageTag };
+//# sourceMappingURL=ColdStorage.mjs.map

package/dist/ColdStorage.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColdStorage.mjs","names":[],"sources":["../src/ColdStorage.ts"],"sourcesContent":["/**\n * @voidhash/mimic-effect - ColdStorage\n *\n * Interface and implementations for document snapshot storage.\n */\nimport { Context, Effect, HashMap, Layer, Ref } from \"effect\";\nimport type { StoredDocument } from \"./Types\";\nimport { ColdStorageError } from \"./Errors\";\n\n// =============================================================================\n// ColdStorage Interface\n// =============================================================================\n\n/**\n * ColdStorage interface for storing document snapshots.\n *\n * This is the \"cold\" tier of the two-tier storage system.\n * It stores complete document snapshots less frequently (on periodic intervals\n * or after a threshold of transactions).\n */\nexport interface ColdStorage {\n  /**\n   * Load a document snapshot.\n   * Returns undefined if the document doesn't exist.\n   */\n  readonly load: (\n    documentId: string\n  ) => Effect.Effect<StoredDocument | undefined, ColdStorageError>;\n\n  /**\n   * Save a document snapshot.\n   */\n  readonly save: (\n    documentId: string,\n    document: StoredDocument\n  ) => Effect.Effect<void, ColdStorageError>;\n\n  /**\n   * Delete a document snapshot.\n   */\n  readonly delete: (\n    documentId: string\n  ) => Effect.Effect<void, ColdStorageError>;\n}\n\n// =============================================================================\n// Context Tag\n// =============================================================================\n\n/**\n * Context tag for ColdStorage service\n */\nexport class ColdStorageTag extends Context.Tag(\"@voidhash/mimic-effect/ColdStorage\")<\n  ColdStorageTag,\n  ColdStorage\n>() {}\n\n// =============================================================================\n// Factory\n// =============================================================================\n\n/**\n * Create a ColdStorage layer from an Effect that produces a ColdStorage service.\n *\n * This allows you to access other Effect services when implementing custom storage.\n *\n * @example\n * ```typescript\n * const Cold = ColdStorage.make(\n *   Effect.gen(function*() {\n *     const redis = yield* RedisService\n *\n *     return {\n *       load: (documentId) => redis.get(`doc:${documentId}`).pipe(\n *         Effect.map(data => data ? JSON.parse(data) : undefined)\n *       ),\n *       save: (documentId, document) =>\n *         redis.set(`doc:${documentId}`, JSON.stringify(document)),\n *       delete: (documentId) => redis.del(`doc:${documentId}`),\n *     }\n *   })\n * )\n * ```\n */\nexport const make = <E, R>(\n  effect: Effect.Effect<ColdStorage, E, R>\n): Layer.Layer<ColdStorageTag, E, R> =>\n  Layer.effect(ColdStorageTag, effect);\n\n// =============================================================================\n// InMemory Implementation\n// =============================================================================\n\n/**\n * In-memory ColdStorage implementation.\n *\n * Useful for testing and development. Not suitable for production\n * as data is lost when the process restarts.\n */\nexport namespace InMemory {\n  /**\n   * Create an in-memory ColdStorage layer.\n   */\n  export const make = (): Layer.Layer<ColdStorageTag> =>\n    Layer.effect(\n      ColdStorageTag,\n      Effect.gen(function* () {\n        const store = yield* Ref.make(HashMap.empty<string, StoredDocument>());\n\n        return {\n          load: (documentId) =>\n            Effect.gen(function* () {\n              const current = yield* Ref.get(store);\n              const result = HashMap.get(current, documentId);\n              return result._tag === \"Some\" ? result.value : undefined;\n            }),\n\n          save: (documentId, document) =>\n            Ref.update(store, (map) => HashMap.set(map, documentId, document)),\n\n          delete: (documentId) =>\n            Ref.update(store, (map) => HashMap.remove(map, documentId)),\n        };\n      })\n    );\n}\n\n// =============================================================================\n// Re-export namespace\n// =============================================================================\n\nexport const ColdStorage = {\n  Tag: ColdStorageTag,\n  make,\n  InMemory,\n};\n"],"mappings":";;;;;;;;;;;AAoDA,IAAa,iBAAb,cAAoC,QAAQ,IAAI,qCAAqC,EAGlF,CAAC;;;;;;;;;;;;;;;;;;;;;;;;AA6BJ,MAAa,QACX,WAEA,MAAM,OAAO,gBAAgB,OAAO;;;wBAiBlC,MAAM,OACJ,gBACA,OAAO,IAAI,aAAa;EACtB,MAAM,QAAQ,OAAO,IAAI,KAAK,QAAQ,OAA+B,CAAC;AAEtE,SAAO;GACL,OAAO,eACL,OAAO,IAAI,aAAa;IACtB,MAAM,UAAU,OAAO,IAAI,IAAI,MAAM;IACrC,MAAM,SAAS,QAAQ,IAAI,SAAS,WAAW;AAC/C,WAAO,OAAO,SAAS,SAAS,OAAO,QAAQ;KAC/C;GAEJ,OAAO,YAAY,aACjB,IAAI,OAAO,QAAQ,QAAQ,QAAQ,IAAI,KAAK,YAAY,SAAS,CAAC;GAEpE,SAAS,eACP,IAAI,OAAO,QAAQ,QAAQ,QAAQ,OAAO,KAAK,WAAW,CAAC;GAC9D;GACD,CACH;;AAOL,MAAa,cAAc;CACzB,KAAK;CACL;CACA;CACD"}