honertia 0.1.31 → 0.1.32

package/README.md

@@ -792,24 +792,39 @@ export const showAbout = action(
 )
 ```
 
-### GET with Authentication
+### GET with Authentication and Caching
 
 ```typescript
-import { Effect } from 'effect'
-import { action, authorize, render, DatabaseService } from 'honertia/effect'
+import { Effect, Schema as S, Duration } from 'effect'
+import { action, authorize, render, DatabaseService, cache } from 'honertia/effect'
 import { eq } from 'drizzle-orm'
 import { projects } from '~/db/schema'
 
+const ProjectSchema = S.Struct({
+  id: S.String,
+  userId: S.String,
+  name: S.String,
+  description: S.NullOr(S.String),
+  createdAt: S.Date,
+  updatedAt: S.Date,
+})
+
 export const listProjects = action(
   Effect.gen(function* () {
     const auth = yield* authorize()
     const db = yield* DatabaseService
 
-    const userProjects = yield* Effect.tryPromise(() =>
-      db.query.projects.findMany({
-        where: eq(projects.userId, auth.user.id),
-        orderBy: (p, { desc }) => [desc(p.createdAt)],
-      })
+    // Cache expensive database query for 5 minutes
+    const userProjects = yield* cache(
+      `projects:user:${auth.user.id}`,
+      Effect.tryPromise(() =>
+        db.query.projects.findMany({
+          where: eq(projects.userId, auth.user.id),
+          orderBy: (p, { desc }) => [desc(p.createdAt)],
+        })
+      ),
+      S.Array(ProjectSchema),
+      Duration.minutes(5)
     )
 
     return yield* render('Projects/Index', { projects: userProjects })
@@ -1532,6 +1547,371 @@ return yield* httpError(429, 'Rate limited')
 
 ---
 
+## Caching
+
+Honertia provides a `CacheService` for caching expensive database operations. It's automatically provided and backed by Cloudflare KV by default, but can be swapped for Redis, Memcached, or any other implementation.
+
+### Setup
+
+Add KV to your `wrangler.toml`:
+
+```toml
+[[kv_namespaces]]
+binding = "KV"
+id = "your-kv-namespace-id"
+```
+
+Update your bindings type in `src/types.ts`:
+
+```typescript
+export type Bindings = {
+  DATABASE_URL: string
+  BETTER_AUTH_SECRET: string
+  KV: KVNamespace  // Add this
+}
+```
+
+No additional registration needed - `CacheService` is automatically available in all actions.
+
+### Basic Usage
+
+```typescript
+import { Effect, Schema as S, Duration } from 'effect'
+import { action, authorize, render, DatabaseService, cache } from 'honertia/effect'
+import { eq } from 'drizzle-orm'
+import { projects } from '~/db/schema'
+
+const ProjectSchema = S.Struct({
+  id: S.String,
+  userId: S.String,
+  name: S.String,
+  description: S.NullOr(S.String),
+  createdAt: S.Date,
+  updatedAt: S.Date,
+})
+
+export const listProjects = action(
+  Effect.gen(function* () {
+    const auth = yield* authorize()
+    const db = yield* DatabaseService
+
+    // Cache the database query for 5 minutes
+    const userProjects = yield* cache(
+      `projects:user:${auth.user.id}`,
+      Effect.tryPromise({
+        try: () =>
+          db.query.projects.findMany({
+            where: eq(projects.userId, auth.user.id),
+            orderBy: (p, { desc }) => [desc(p.createdAt)],
+          }),
+        catch: (error) => new Error(String(error)),
+      }),
+      S.Array(ProjectSchema),
+      Duration.minutes(5)
+    )
+
+    return yield* render('Projects/Index', { projects: userProjects })
+  })
+)
+```
+
+### Cache Functions
+
+| Function | Description |
+|----------|-------------|
+| `cache(key, compute, schema, ttl)` | Get from cache or compute and store |
+| `cacheGet(key, schema)` | Get value from cache (returns `Option`) |
+| `cacheSet(key, value, schema, ttl)` | Store value in cache |
+| `cacheInvalidate(key)` | Delete a single cache key |
+| `cacheInvalidatePrefix(prefix)` | Delete all keys with prefix |
+
+### Cache Invalidation
+
+Invalidate cache when data changes:
+
+```typescript
+import { Effect, Schema as S } from 'effect'
+import {
+  action,
+  authorize,
+  validateRequest,
+  DatabaseService,
+  redirect,
+  asTrusted,
+  dbMutation,
+  requiredString,
+  cacheInvalidate,
+} from 'honertia/effect'
+import { projects } from '~/db/schema'
+
+const CreateProjectSchema = S.Struct({
+  name: requiredString,
+  description: S.optional(S.String),
+})
+
+export const createProject = action(
+  Effect.gen(function* () {
+    const auth = yield* authorize()
+    const input = yield* validateRequest(CreateProjectSchema, {
+      errorComponent: 'Projects/Create',
+    })
+    const db = yield* DatabaseService
+
+    yield* dbMutation(db, async (db) => {
+      await db.insert(projects).values(
+        asTrusted({
+          name: input.name,
+          description: input.description ?? null,
+          userId: auth.user.id,
+        })
+      )
+    })
+
+    // Invalidate the user's project list cache
+    yield* cacheInvalidate(`projects:user:${auth.user.id}`)
+
+    return yield* redirect('/projects')
+  })
+)
+```
+
+### Invalidate by Prefix
+
+Delete all cache keys matching a prefix:
+
+```typescript
+import { cacheInvalidatePrefix } from 'honertia/effect'
+
+// Invalidate all caches for a user
+yield* cacheInvalidatePrefix(`user:${userId}:`)
+
+// Invalidate all project-related caches
+yield* cacheInvalidatePrefix('projects:')
+```
+
+### Manual Get/Set
+
+For more control over cache operations:
+
+```typescript
+import { Effect, Option, Schema as S, Duration } from 'effect'
+import { cacheGet, cacheSet } from 'honertia/effect'
+
+const UserSchema = S.Struct({
+  id: S.String,
+  name: S.String,
+  email: S.String,
+})
+
+// Check cache first
+const cached = yield* cacheGet(`user:${id}`, UserSchema)
+
+if (Option.isSome(cached)) {
+  return cached.value
+}
+
+// Compute value
+const user = yield* fetchUser(id)
+
+// Store in cache
+yield* cacheSet(`user:${id}`, user, UserSchema, Duration.hours(1))
+
+return user
+```
+
+### Using CacheService Directly
+
+For advanced use cases, access the underlying service:
+
+```typescript
+import { Effect } from 'effect'
+import { CacheService } from 'honertia/effect'
+
+const handler = action(
+  Effect.gen(function* () {
+    const cache = yield* CacheService
+
+    // Raw get (returns string | null)
+    const raw = yield* cache.get('my-key')
+
+    // Raw put
+    yield* cache.put('my-key', JSON.stringify({ data: 'value' }), {
+      expirationTtl: 3600, // seconds
+    })
+
+    // Delete
+    yield* cache.delete('my-key')
+
+    // List keys by prefix
+    const keys = yield* cache.list({ prefix: 'user:' })
+  })
+)
+```
+
+### Custom Cache Implementation
+
+Swap out Cloudflare KV for Redis or any other backend by providing a custom `CacheService` layer:
+
+```typescript
+import { Effect, Layer } from 'effect'
+import { CacheService, CacheClientError, type CacheClient } from 'honertia/effect'
+import { createClient } from 'redis'
+
+const createRedisCacheClient = (redisUrl: string): CacheClient => {
+  const client = createClient({ url: redisUrl })
+
+  return {
+    get: (key) =>
+      Effect.tryPromise({
+        try: () => client.get(key),
+        catch: (e) => new CacheClientError('Redis get failed', e),
+      }),
+    put: (key, value, options) =>
+      Effect.tryPromise({
+        try: () =>
+          client.set(key, value, options?.expirationTtl ? { EX: options.expirationTtl } : undefined),
+        catch: (e) => new CacheClientError('Redis set failed', e),
+      }).pipe(Effect.asVoid),
+    delete: (key) =>
+      Effect.tryPromise({
+        try: () => client.del(key),
+        catch: (e) => new CacheClientError('Redis delete failed', e),
+      }).pipe(Effect.asVoid),
+    list: (options) =>
+      Effect.tryPromise({
+        try: async () => {
+          const keys = await client.keys(options?.prefix ? `${options.prefix}*` : '*')
+          return { keys: keys.map((name) => ({ name })) }
+        },
+        catch: (e) => new CacheClientError('Redis keys failed', e),
+      }),
+  }
+}
+
+// Provide in your app setup
+const RedisCacheLayer = Layer.succeed(
+  CacheService,
+  createRedisCacheClient(process.env.REDIS_URL!)
+)
+```
+
+### Testing with Cache
+
+Create a test layer that uses an in-memory store:
+
+```typescript
+import { Effect, Layer, Option, Schema as S, Duration } from 'effect'
+import { CacheService, cache, cacheGet, cacheInvalidate, type CacheClient } from 'honertia/effect'
+import { describe, it, expect } from 'bun:test'
+
+const makeTestCache = (): Layer.Layer<CacheService> => {
+  const store = new Map<string, { value: string; expiresAt: number }>()
+
+  const client: CacheClient = {
+    get: (key) =>
+      Effect.sync(() => {
+        const entry = store.get(key)
+        if (!entry || entry.expiresAt < Date.now()) {
+          store.delete(key)
+          return null
+        }
+        return entry.value
+      }),
+    put: (key, value, options) =>
+      Effect.sync(() => {
+        const ttlMs = (options?.expirationTtl ?? 3600) * 1000
+        store.set(key, { value, expiresAt: Date.now() + ttlMs })
+      }),
+    delete: (key) =>
+      Effect.sync(() => {
+        store.delete(key)
+      }),
+    list: (options) =>
+      Effect.sync(() => ({
+        keys: [...store.keys()]
+          .filter((k) => !options?.prefix || k.startsWith(options.prefix))
+          .map((name) => ({ name })),
+      })),
+  }
+
+  return Layer.succeed(CacheService, client)
+}
+
+const TestSchema = S.Struct({
+  id: S.String,
+  name: S.String,
+})
+
+describe('cache', () => {
+  it('returns cached value on second call', () =>
+    Effect.gen(function* () {
+      let callCount = 0
+
+      const compute = Effect.sync(() => {
+        callCount++
+        return { id: '1', name: 'Test' }
+      })
+
+      const first = yield* cache('test:1', compute, TestSchema, Duration.hours(1))
+      const second = yield* cache('test:1', compute, TestSchema, Duration.hours(1))
+
+      expect(first).toEqual(second)
+      expect(callCount).toBe(1) // Only computed once
+    }).pipe(Effect.provide(makeTestCache()), Effect.runPromise))
+
+  it('recomputes after invalidation', () =>
+    Effect.gen(function* () {
+      let callCount = 0
+
+      const compute = Effect.sync(() => {
+        callCount++
+        return { id: '1', name: `Call ${callCount}` }
+      })
+
+      yield* cache('test:1', compute, TestSchema, Duration.hours(1))
+      yield* cacheInvalidate('test:1')
+      yield* cache('test:1', compute, TestSchema, Duration.hours(1))
+
+      expect(callCount).toBe(2) // Computed twice
+    }).pipe(Effect.provide(makeTestCache()), Effect.runPromise))
+
+  it('returns Option.none for missing keys', () =>
+    Effect.gen(function* () {
+      const result = yield* cacheGet('nonexistent', TestSchema)
+      expect(Option.isNone(result)).toBe(true)
+    }).pipe(Effect.provide(makeTestCache()), Effect.runPromise))
+})
+```
+
+### Cache Key Patterns
+
+Recommended cache key patterns:
+
+```typescript
+// User-scoped data
+`user:${userId}:profile`
+`user:${userId}:settings`
+`user:${userId}:notifications`
+
+// Resource lists
+`projects:user:${userId}`
+`posts:category:${categoryId}`
+
+// Individual resources
+`project:${projectId}`
+`user:${userId}`
+
+// Computed data
+`stats:daily:${date}`
+`leaderboard:weekly`
+
+// API responses
+`api:weather:${city}`
+`api:exchange:${currency}`
+```
+
+---
+
 ## Services Reference
 
 | Service | Description | Usage |
@@ -1540,6 +1920,7 @@ return yield* httpError(429, 'Rate limited')
 | `AuthService` | Better-auth instance | `const auth = yield* AuthService` |
 | `AuthUserService` | Current user session | `const user = yield* AuthUserService` |
 | `BindingsService` | Cloudflare bindings | `const { KV } = yield* BindingsService` |
+| `CacheService` | KV-backed cache client | `const cache = yield* CacheService` |
 | `RequestService` | Request context | `const req = yield* RequestService` |
 
 ### Using BindingsService

package/dist/cache.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Cache Module
+ *
+ * Simple cache abstraction for storing expensive DB operations.
+ * Uses CacheService which is automatically provided and backed by Cloudflare KV by default.
+ * Can be swapped for Redis, Memcached, or any other implementation.
+ */
+import { Effect, Option, Schema, ParseResult, Duration } from 'effect';
+import { CacheService, CacheClientError } from './effect/services.js';
+declare const CacheError_base: Schema.TaggedErrorClass<CacheError, "CacheError", {
+    readonly _tag: Schema.tag<"CacheError">;
+} & {
+    reason: typeof Schema.String;
+    cause: Schema.optional<typeof Schema.Unknown>;
+}>;
+export declare class CacheError extends CacheError_base {
+}
+/**
+ * Cache a computed value with automatic serialization and TTL.
+ *
+ * @example
+ * ```typescript
+ * const user = yield* cache(
+ *   `user:${id}`,
+ *   Effect.tryPromise(() => db.query.users.findFirst({ where: eq(users.id, id) })),
+ *   UserSchema,
+ *   Duration.hours(1)
+ * )
+ * ```
+ */
+export declare const cache: <V, E, R>(key: string, compute: Effect.Effect<V, E, R>, schema: Schema.Schema<V>, ttl: Duration.DurationInput) => Effect.Effect<V, E | CacheError | CacheClientError | ParseResult.ParseError, R | CacheService>;
+/**
+ * Get a value from cache without computing.
+ *
+ * @example
+ * ```typescript
+ * const cached = yield* cacheGet(`user:${id}`, UserSchema)
+ * if (Option.isSome(cached)) {
+ *   return cached.value
+ * }
+ * ```
+ */
+export declare const cacheGet: <V>(key: string, schema: Schema.Schema<V>) => Effect.Effect<Option.Option<V>, CacheError | CacheClientError | ParseResult.ParseError, CacheService>;
+/**
+ * Set a value in cache.
+ *
+ * @example
+ * ```typescript
+ * yield* cacheSet(`user:${id}`, user, UserSchema, Duration.hours(1))
+ * ```
+ */
+export declare const cacheSet: <V>(key: string, value: V, schema: Schema.Schema<V>, ttl: Duration.DurationInput) => Effect.Effect<void, CacheError | CacheClientError | ParseResult.ParseError, CacheService>;
+/**
+ * Invalidate a cache key.
+ *
+ * @example
+ * ```typescript
+ * yield* cacheInvalidate(`user:${id}`)
+ * ```
+ */
+export declare const cacheInvalidate: (key: string) => Effect.Effect<void, CacheClientError, CacheService>;
+/**
+ * Invalidate all cache keys with a given prefix.
+ *
+ * @example
+ * ```typescript
+ * yield* cacheInvalidatePrefix(`user:${userId}:`)
+ * ```
+ */
+export declare const cacheInvalidatePrefix: (prefix: string) => Effect.Effect<void, CacheClientError, CacheService>;
+export {};
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AACtE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;;;;;;;AAMrE,qBAAa,UAAW,SAAQ,eAG9B;CAAG;AAML;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAC3B,KAAK,MAAM,EACX,SAAS,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAC/B,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EACxB,KAAK,QAAQ,CAAC,aAAa,KAC1B,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,UAAU,GAAG,gBAAgB,GAAG,WAAW,CAAC,UAAU,EAAE,CAAC,GAAG,YAAY,CAqB5F,CAAA;AAEJ;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,EACxB,KAAK,MAAM,EACX,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KACvB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,GAAG,gBAAgB,GAAG,WAAW,CAAC,UAAU,EAAE,YAAY,CAYnG,CAAA;AAEJ;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,EACxB,KAAK,MAAM,EACX,OAAO,CAAC,EACR,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EACxB,KAAK,QAAQ,CAAC,aAAa,KAC1B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,gBAAgB,GAAG,WAAW,CAAC,UAAU,EAAE,YAAY,CAQvF,CAAA;AAEJ;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAC1B,KAAK,MAAM,KACV,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,EAAE,YAAY,CAIjD,CAAA;AAEJ;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,MAAM,KACb,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,EAAE,YAAY,CAWjD,CAAA"}

package/dist/cache.js

@@ -0,0 +1,107 @@
+/**
+ * Cache Module
+ *
+ * Simple cache abstraction for storing expensive DB operations.
+ * Uses CacheService which is automatically provided and backed by Cloudflare KV by default.
+ * Can be swapped for Redis, Memcached, or any other implementation.
+ */
+import { Effect, Option, Schema, Duration } from 'effect';
+import { CacheService } from './effect/services.js';
+// ============================================================================
+// Errors
+// ============================================================================
+export class CacheError extends Schema.TaggedError()('CacheError', {
+    reason: Schema.String,
+    cause: Schema.optional(Schema.Unknown),
+}) {
+}
+// ============================================================================
+// Composable API
+// ============================================================================
+/**
+ * Cache a computed value with automatic serialization and TTL.
+ *
+ * @example
+ * ```typescript
+ * const user = yield* cache(
+ *   `user:${id}`,
+ *   Effect.tryPromise(() => db.query.users.findFirst({ where: eq(users.id, id) })),
+ *   UserSchema,
+ *   Duration.hours(1)
+ * )
+ * ```
+ */
+export const cache = (key, compute, schema, ttl) => Effect.gen(function* () {
+    const cacheService = yield* CacheService;
+    // Check cache first
+    const cached = yield* cacheService.get(key);
+    if (cached !== null) {
+        return yield* Schema.decodeUnknown(Schema.parseJson(schema))(cached);
+    }
+    // Compute value
+    const value = yield* compute;
+    // Store in cache
+    const serialized = yield* Schema.encode(Schema.parseJson(schema))(value);
+    const ttlSeconds = Duration.toSeconds(Duration.decode(ttl));
+    yield* cacheService.put(key, serialized, { expirationTtl: ttlSeconds });
+    return value;
+});
+/**
+ * Get a value from cache without computing.
+ *
+ * @example
+ * ```typescript
+ * const cached = yield* cacheGet(`user:${id}`, UserSchema)
+ * if (Option.isSome(cached)) {
+ *   return cached.value
+ * }
+ * ```
+ */
+export const cacheGet = (key, schema) => Effect.gen(function* () {
+    const cacheService = yield* CacheService;
+    const cached = yield* cacheService.get(key);
+    if (cached === null) {
+        return Option.none();
+    }
+    const decoded = yield* Schema.decodeUnknown(Schema.parseJson(schema))(cached);
+    return Option.some(decoded);
+});
+/**
+ * Set a value in cache.
+ *
+ * @example
+ * ```typescript
+ * yield* cacheSet(`user:${id}`, user, UserSchema, Duration.hours(1))
+ * ```
+ */
+export const cacheSet = (key, value, schema, ttl) => Effect.gen(function* () {
+    const cacheService = yield* CacheService;
+    const serialized = yield* Schema.encode(Schema.parseJson(schema))(value);
+    const ttlSeconds = Duration.toSeconds(Duration.decode(ttl));
+    yield* cacheService.put(key, serialized, { expirationTtl: ttlSeconds });
+});
+/**
+ * Invalidate a cache key.
+ *
+ * @example
+ * ```typescript
+ * yield* cacheInvalidate(`user:${id}`)
+ * ```
+ */
+export const cacheInvalidate = (key) => Effect.gen(function* () {
+    const cacheService = yield* CacheService;
+    yield* cacheService.delete(key);
+});
+/**
+ * Invalidate all cache keys with a given prefix.
+ *
+ * @example
+ * ```typescript
+ * yield* cacheInvalidatePrefix(`user:${userId}:`)
+ * ```
+ */
+export const cacheInvalidatePrefix = (prefix) => Effect.gen(function* () {
+    const cacheService = yield* CacheService;
+    const list = yield* cacheService.list({ prefix });
+    yield* Effect.forEach(list.keys, (key) => cacheService.delete(key.name), { concurrency: 10 });
+});

package/dist/effect/bridge.d.ts

@@ -5,7 +5,7 @@
  */
 import { Layer, ManagedRuntime } from 'effect';
 import type { Context as HonoContext, MiddlewareHandler, Env } from 'hono';
-import { DatabaseService, AuthService, AuthUserService, HonertiaService, RequestService, ResponseFactoryService, BindingsService } from './services.js';
+import { DatabaseService, AuthService, AuthUserService, HonertiaService, RequestService, ResponseFactoryService, BindingsService, CacheService } from './services.js';
 /**
  * Configuration for the Effect bridge.
  *
@@ -61,7 +61,7 @@ declare module 'hono' {
 /**
  * Build the Effect layer from Hono context.
  */
-export declare function buildContextLayer<E extends Env, CustomServices = never>(c: HonoContext<E>, config?: EffectBridgeConfig<E, CustomServices>): Layer.Layer<RequestService | ResponseFactoryService | HonertiaService | DatabaseService | AuthService | AuthUserService | BindingsService | CustomServices, never, never>;
+export declare function buildContextLayer<E extends Env, CustomServices = never>(c: HonoContext<E>, config?: EffectBridgeConfig<E, CustomServices>): Layer.Layer<RequestService | ResponseFactoryService | HonertiaService | DatabaseService | AuthService | AuthUserService | BindingsService | CacheService | CustomServices, never, never>;
 /**
  * Get the Effect runtime from Hono context.
  */

package/dist/effect/bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/effect/bridge.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAU,KAAK,EAAE,cAAc,EAAU,MAAM,QAAQ,CAAA;AAG9D,OAAO,KAAK,EAAE,OAAO,IAAI,WAAW,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAC1E,OAAO,EACL,eAAe,EACf,WAAW,EACX,eAAe,EACf,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,eAAe,EAQhB,MAAM,eAAe,CAAA;AAGtB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,GAAG,EAAE,cAAc,GAAG,KAAK;IACvE;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,EAAE,KAAK,CAAC,CAAA;IAC3E;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AAED;;GAEG;AACH,QAAA,MAAM,cAAc,eAA0B,CAAA;AAE9C;;GAEG;AACH,QAAA,MAAM,aAAa,eAAyB,CAAA;AAa5C,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAM7D;AAqCD;;GAEG;AACH,OAAO,QAAQ,MAAM,CAAC;IACpB,UAAU,kBAAkB;QAC1B,CAAC,cAAc,CAAC,CAAC,EAAE,cAAc,CAAC,cAAc,CAC5C,eAAe,GACf,WAAW,GACX,eAAe,GACf,eAAe,GACf,cAAc,GACd,sBAAsB,EACxB,KAAK,CACN,CAAA;QACD,CAAC,aAAa,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAC1C;CACF;AAsDD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,GAAG,EAAE,cAAc,GAAG,KAAK,EACrE,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,EACjB,MAAM,CAAC,EAAE,kBAAkB,CAAC,CAAC,EAAE,cAAc,CAAC,GAC7C,KAAK,CAAC,KAAK,CACV,cAAc,GACd,sBAAsB,GACtB,eAAe,GACf,eAAe,GACf,WAAW,GACX,eAAe,GACf,eAAe,GACf,cAAc,EAChB,KAAK,EACL,KAAK,CACN,CAoEA;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,GAAG,EAC5C,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GAChB,cAAc,CAAC,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,SAAS,CAEvD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,GAAG,EAAE,cAAc,GAAG,KAAK,EAChE,MAAM,CAAC,EAAE,kBAAkB,CAAC,CAAC,EAAE,cAAc,CAAC,GAC7C,iBAAiB,CAAC,CAAC,CAAC,CA6CtB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,GAAG,EAC3C,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAErC"}
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/effect/bridge.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAU,KAAK,EAAE,cAAc,EAAU,MAAM,QAAQ,CAAA;AAG9D,OAAO,KAAK,EAAE,OAAO,IAAI,WAAW,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAC1E,OAAO,EACL,eAAe,EACf,WAAW,EACX,eAAe,EACf,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,eAAe,EACf,YAAY,EAUb,MAAM,eAAe,CAAA;AAGtB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,GAAG,EAAE,cAAc,GAAG,KAAK;IACvE;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,EAAE,KAAK,CAAC,CAAA;IAC3E;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AAED;;GAEG;AACH,QAAA,MAAM,cAAc,eAA0B,CAAA;AAE9C;;GAEG;AACH,QAAA,MAAM,aAAa,eAAyB,CAAA;AAa5C,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAM7D;AAqCD;;GAEG;AACH,OAAO,QAAQ,MAAM,CAAC;IACpB,UAAU,kBAAkB;QAC1B,CAAC,cAAc,CAAC,CAAC,EAAE,cAAc,CAAC,cAAc,CAC5C,eAAe,GACf,WAAW,GACX,eAAe,GACf,eAAe,GACf,cAAc,GACd,sBAAsB,EACxB,KAAK,CACN,CAAA;QACD,CAAC,aAAa,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAC1C;CACF;AA2GD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,GAAG,EAAE,cAAc,GAAG,KAAK,EACrE,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,EACjB,MAAM,CAAC,EAAE,kBAAkB,CAAC,CAAC,EAAE,cAAc,CAAC,GAC7C,KAAK,CAAC,KAAK,CACV,cAAc,GACd,sBAAsB,GACtB,eAAe,GACf,eAAe,GACf,WAAW,GACX,eAAe,GACf,eAAe,GACf,YAAY,GACZ,cAAc,EAChB,KAAK,EACL,KAAK,CACN,CA6EA;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,GAAG,EAC5C,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GAChB,cAAc,CAAC,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,SAAS,CAEvD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,GAAG,EAAE,cAAc,GAAG,KAAK,EAChE,MAAM,CAAC,EAAE,kBAAkB,CAAC,CAAC,EAAE,cAAc,CAAC,GAC7C,iBAAiB,CAAC,CAAC,CAAC,CA6CtB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,GAAG,EAC3C,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAErC"}

package/dist/effect/bridge.js

@@ -6,7 +6,7 @@
 import { Effect, Layer, ManagedRuntime, Option } from 'effect';
 import { HonertiaConfigurationError } from './errors.js';
 import { ErrorCodes } from './error-catalog.js';
-import { DatabaseService, AuthService, AuthUserService, HonertiaService, RequestService, ResponseFactoryService, BindingsService, } from './services.js';
+import { DatabaseService, AuthService, AuthUserService, HonertiaService, RequestService, ResponseFactoryService, BindingsService, CacheService, CacheClientError, } from './services.js';
 import { TestCaptureService } from './test-layers.js';
 /**
  * Symbol for storing Effect runtime in Hono context.
@@ -88,6 +88,41 @@ function createResponseFactory(c) {
         notFound: () => c.notFound(),
     };
 }
+/**
+ * Create a CacheClient from Cloudflare KV binding.
+ */
+function createKVCacheClient(kv) {
+    return {
+        get: (key) => Effect.tryPromise({
+            try: () => kv.get(key),
+            catch: (e) => new CacheClientError('Failed to get from cache', e),
+        }),
+        put: (key, value, options) => Effect.tryPromise({
+            try: () => kv.put(key, value, options),
+            catch: (e) => new CacheClientError('Failed to set cache', e),
+        }),
+        delete: (key) => Effect.tryPromise({
+            try: () => kv.delete(key),
+            catch: (e) => new CacheClientError('Failed to delete from cache', e),
+        }),
+        list: (options) => Effect.tryPromise({
+            try: () => kv.list(options),
+            catch: (e) => new CacheClientError('Failed to list cache keys', e),
+        }),
+    };
+}
+/**
+ * Create a no-op CacheClient that fails with helpful errors when KV is not configured.
+ */
+function createUnconfiguredCacheClient() {
+    const error = new CacheClientError('CacheService requires KV binding. Add KV to your wrangler.toml and ensure it is available in c.env.KV');
+    return {
+        get: () => Effect.fail(error),
+        put: () => Effect.fail(error),
+        delete: () => Effect.fail(error),
+        list: () => Effect.fail(error),
+    };
+}
 /**
  * Create a HonertiaRenderer from Hono context.
  */
@@ -115,6 +150,9 @@ export function buildContextLayer(c, config) {
     const honertiaLayer = Layer.succeed(HonertiaService, createHonertiaRenderer(c));
     // Bindings layer - always available, typed via module augmentation
     const bindingsLayer = Layer.succeed(BindingsService, (c.env ?? {}));
+    // Cache layer - backed by KV if available, otherwise unconfigured client
+    const kv = c.env?.KV;
+    const cacheLayer = Layer.succeed(CacheService, kv ? createKVCacheClient(kv) : createUnconfiguredCacheClient());
     // Database layer - provide helpful error proxy if not configured
     const db = c.var?.db;
     const databaseLayer = Layer.succeed(DatabaseService, (db ??
@@ -123,7 +161,7 @@ export function buildContextLayer(c, config) {
     const auth = c.var?.auth;
     const authLayer = Layer.succeed(AuthService, (auth ??
         createUnconfiguredServiceProxy('AuthService', 'auth: (c) => createAuth(...)', 'auth: (c) => betterAuth({ database: c.var.db, ... })', ErrorCodes.CFG_301_AUTH_NOT_CONFIGURED)));
-    let baseLayer = Layer.mergeAll(requestLayer, responseLayer, honertiaLayer, bindingsLayer, databaseLayer, authLayer);
+    let baseLayer = Layer.mergeAll(requestLayer, responseLayer, honertiaLayer, bindingsLayer, cacheLayer, databaseLayer, authLayer);
     if (c.var?.authUser) {
         baseLayer = Layer.merge(baseLayer, Layer.succeed(AuthUserService, c.var.authUser));
     }

package/dist/effect/index.d.ts

@@ -3,7 +3,7 @@
  *
  * Re-exports all Effect-related functionality.
  */
-export { DatabaseService, AuthService, AuthUserService, EmailService, HonertiaService, RequestService, ResponseFactoryService, BindingsService, type AuthUser, type EmailClient, type HonertiaRenderer, type RequestContext, type ResponseFactory, type HonertiaDatabaseType, type HonertiaAuthType, type HonertiaBindingsType, type DatabaseType, type SchemaType, type AuthType, type BindingsType, } from './services.js';
+export { DatabaseService, AuthService, AuthUserService, EmailService, HonertiaService, RequestService, ResponseFactoryService, BindingsService, CacheService, CacheClientError, type AuthUser, type EmailClient, type HonertiaRenderer, type RequestContext, type ResponseFactory, type CacheClient, type HonertiaDatabaseType, type HonertiaAuthType, type HonertiaBindingsType, type DatabaseType, type SchemaType, type AuthType, type BindingsType, } from './services.js';
 export { ValidationError, UnauthorizedError, NotFoundError, ForbiddenError, HttpError, RouteConfigurationError, HonertiaConfigurationError, Redirect, isStructuredError, toStructuredError, type AppError, type StructuredErrorCapable, } from './errors.js';
 export type { ErrorCategory, ErrorContext, SourceLocation, CodeSnippet, RouteContext, HandlerContext, RequestContext as ErrorRequestContext, ServiceContext, FixType, FixPosition, FixOperation, PostAction, FixSuggestion, ErrorDocs, HonertiaStructuredError, FieldError, ValidationErrorData, ConfigurationErrorData, BindingErrorData, ErrorDefinition, FixGenerator, } from './error-types.js';
 export { ErrorCodes, ErrorCatalog, createStructuredError, getConfigErrorCode, getErrorDefinition, getErrorsByCategory, type ErrorCode, } from './error-catalog.js';
@@ -21,5 +21,6 @@ export { RouteRegistry, getGlobalRegistry, resetGlobalRegistry, type HttpMethod,
 export { describeRoute, createRouteTester, generateTestCases, type TestUserType, type TestUser, type TestRequestOptions, type TestExpectation, type TestContext, type TestCaseOptions, type TestFn, type TestAppConfig, } from './testing.js';
 export { TestLayer, TestCaptureService, type TestCaptures, } from './test-layers.js';
 export { BoundModels, BoundModelNotFound, bound, pluralize, parseBindings, toHonoPath, type ParsedBinding, type BoundModel, } from './binding.js';
+export { CacheError, cache, cacheGet, cacheSet, cacheInvalidate, cacheInvalidatePrefix, } from '../cache.js';
 export { RequireAuthLayer, RequireGuestLayer, isAuthenticated, currentUser, requireAuth, requireGuest, shareAuth, shareAuthMiddleware, effectAuthRoutes, betterAuthFormAction, betterAuthLogoutAction, loadUser, type AuthRoutesConfig, type BetterAuthFormActionConfig, type BetterAuthLogoutConfig, type BetterAuthActionResult, } from './auth.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/effect/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/effect/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/effect/index.ts"],"names":[],"mappings":"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"}

package/dist/effect/index.js

@@ -4,7 +4,7 @@
  * Re-exports all Effect-related functionality.
  */
 // Services
-export { DatabaseService, AuthService, AuthUserService, EmailService, HonertiaService, RequestService, ResponseFactoryService, BindingsService, } from './services.js';
+export { DatabaseService, AuthService, AuthUserService, EmailService, HonertiaService, RequestService, ResponseFactoryService, BindingsService, CacheService, CacheClientError, } from './services.js';
 // Errors
 export { ValidationError, UnauthorizedError, NotFoundError, ForbiddenError, HttpError, RouteConfigurationError, HonertiaConfigurationError, Redirect, isStructuredError, toStructuredError, } from './errors.js';
 // Error Catalog
@@ -37,5 +37,7 @@ export { describeRoute, createRouteTester, generateTestCases, } from './testing.
 export { TestLayer, TestCaptureService, } from './test-layers.js';
 // Route Model Binding
 export { BoundModels, BoundModelNotFound, bound, pluralize, parseBindings, toHonoPath, } from './binding.js';
+// Cache
+export { CacheError, cache, cacheGet, cacheSet, cacheInvalidate, cacheInvalidatePrefix, } from '../cache.js';
 // Auth
 export { RequireAuthLayer, RequireGuestLayer, isAuthenticated, currentUser, requireAuth, requireGuest, shareAuth, shareAuthMiddleware, effectAuthRoutes, betterAuthFormAction, betterAuthLogoutAction, loadUser, } from './auth.js';

package/dist/effect/services.d.ts

@@ -212,5 +212,44 @@ export interface ResponseFactory {
 declare const ResponseFactoryService_base: Context.TagClass<ResponseFactoryService, "honertia/ResponseFactory", ResponseFactory>;
 export declare class ResponseFactoryService extends ResponseFactoryService_base {
 }
+/**
+ * Cache Service - KV-backed caching for expensive operations
+ *
+ * Automatically provided by setupHonertia when KV binding is available.
+ * Falls back to a no-op implementation if KV is not configured.
+ *
+ * @example
+ * ```typescript
+ * // In your action
+ * const cacheService = yield* CacheService
+ * const cached = yield* cacheService.get('user:123')
+ * ```
+ */
+export interface CacheClient {
+    get(key: string): Effect.Effect<string | null, CacheClientError>;
+    put(key: string, value: string, options?: {
+        expirationTtl?: number;
+    }): Effect.Effect<void, CacheClientError>;
+    delete(key: string): Effect.Effect<void, CacheClientError>;
+    list(options?: {
+        prefix?: string;
+    }): Effect.Effect<{
+        keys: Array<{
+            name: string;
+        }>;
+    }, CacheClientError>;
+}
+/**
+ * Error from cache client operations.
+ */
+export declare class CacheClientError {
+    readonly reason: string;
+    readonly cause?: unknown | undefined;
+    readonly _tag = "CacheClientError";
+    constructor(reason: string, cause?: unknown | undefined);
+}
+declare const CacheService_base: Context.TagClass<CacheService, "honertia/Cache", CacheClient>;
+export declare class CacheService extends CacheService_base {
+}
 export {};
 //# sourceMappingURL=services.d.ts.map

package/dist/effect/services.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../src/effect/services.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../src/effect/services.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE7C;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,oBAAoB;CAAG;AAExC;;;GAGG;AACH,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,OAAO,EAAE,wJAAwJ,CAAA;IAC1K,QAAQ,CAAC,MAAM,EAAE,iEAAiE,CAAA;CACnF;AAED;;GAEG;AACH,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,OAAO,EAAE,uKAAuK,CAAA;IACzL,QAAQ,CAAC,MAAM,EAAE,yEAAyE,CAAA;CAC3F;AAED,yFAAyF;AACzF,MAAM,MAAM,YAAY,GAAG,oBAAoB,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,qBAAqB,CAAA;AAErG,uFAAuF;AACvF,MAAM,MAAM,UAAU,GAAG,oBAAoB,SAAS;IAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,mBAAmB,CAAA;AAEnG;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,gBAAgB;CAAG;AAEpC;;GAEG;AACH,UAAU,iBAAiB;IACzB,QAAQ,CAAC,OAAO,EAAE,kJAAkJ,CAAA;IACpK,QAAQ,CAAC,MAAM,EAAE,qDAAqD,CAAA;CACvE;AAED,qFAAqF;AACrF,MAAM,MAAM,QAAQ,GAAG,gBAAgB,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,iBAAiB,CAAA;AAEzF;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,oBAAoB;CAAG;AAUxC,4GAA4G;AAC5G,MAAM,MAAM,YAAY,GAAG,oBAAoB,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC,CAAA;CAAE,GACrE,CAAC,GACD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAE3B;;GAEG;AACH,QAAA,MAAM,oBAAoB,EAAE,OAAO,CAAC,QAAQ,CAC1C,eAAe,EACf,mBAAmB,EACnB,YAAY,CACuD,CAAA;AAErE,qBAAa,eAAgB,SAAQ,oBAAoB;CAAG;AAE5D;;GAEG;AACH,QAAA,MAAM,gBAAgB,EAAE,OAAO,CAAC,QAAQ,CACtC,WAAW,EACX,eAAe,EACf,QAAQ,CAC+C,CAAA;AAEzD,qBAAa,WAAY,SAAQ,gBAAgB;CAAG;AAEpD;;;;;;;;;;;;;;;;;GAiBG;AACH,QAAA,MAAM,oBAAoB,EAAE,OAAO,CAAC,QAAQ,CAC1C,eAAe,EACf,mBAAmB,EACnB,YAAY,CACuD,CAAA;AAErE,qBAAa,eAAgB,SAAQ,oBAAoB;CAAG;AAE5D;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM,CAAA;QACV,KAAK,EAAE,MAAM,CAAA;QACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;QACnB,aAAa,EAAE,OAAO,CAAA;QACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;QACpB,SAAS,EAAE,IAAI,CAAA;QACf,SAAS,EAAE,IAAI,CAAA;KAChB,CAAA;IACD,OAAO,EAAE;QACP,EAAE,EAAE,MAAM,CAAA;QACV,MAAM,EAAE,MAAM,CAAA;QACd,SAAS,EAAE,IAAI,CAAA;QACf,KAAK,EAAE,MAAM,CAAA;QACb,SAAS,EAAE,IAAI,CAAA;QACf,SAAS,EAAE,IAAI,CAAA;KAChB,CAAA;CACF;;AAED,qBAAa,eAAgB,SAAQ,oBAGlC;CAAG;AAEN;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;CAChF;;AAED,qBAAa,YAAa,SAAQ,iBAG/B;CAAG;AAEN;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,CAAC,GACR,OAAO,CAAC,QAAQ,CAAC,CAAA;IACpB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;IACxC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAA;CAChD;;AAED,qBAAa,eAAgB,SAAQ,oBAGlC;CAAG;AAEN;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAChE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB;;;;;;;;OAQG;IACH,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAA;IACtB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IACvC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,IAAI,CAAC,CAAC,GAAG,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;IAC/B,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAC7C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CACzC;;AAED,qBAAa,cAAe,SAAQ,mBAGjC;CAAG;AAEN;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;IAChD,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;IAC3C,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;IAC7C,QAAQ,IAAI,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;CACzC;;AAED,qBAAa,sBAAuB,SAAQ,2BAGzC;CAAG;AAEN;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,EAAE,gBAAgB,CAAC,CAAA;IAChE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAA;IAC5G,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAA;IAC1D,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,CAAC;QAAE,IAAI,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,EAAE,gBAAgB,CAAC,CAAA;CACxG;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAGzB,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO;IAH1B,QAAQ,CAAC,IAAI,sBAAqB;gBAEvB,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,OAAO,YAAA;CAE3B;;AAED,qBAAa,YAAa,SAAQ,iBAG/B;CAAG"}

package/dist/effect/services.js

@@ -47,3 +47,17 @@ export class RequestService extends Context.Tag('honertia/Request')() {
 }
 export class ResponseFactoryService extends Context.Tag('honertia/ResponseFactory')() {
 }
+/**
+ * Error from cache client operations.
+ */
+export class CacheClientError {
+    reason;
+    cause;
+    _tag = 'CacheClientError';
+    constructor(reason, cause) {
+        this.reason = reason;
+        this.cause = cause;
+    }
+}
+export class CacheService extends Context.Tag('honertia/Cache')() {
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "honertia",
-  "version": "0.1.31",
+  "version": "0.1.32",
   "description": "Inertia.js-style server-driven SPA adapter for Hono",
   "type": "module",
   "main": "./dist/index.js",
@@ -30,6 +30,10 @@
     "./cli": {
       "types": "./dist/cli/index.d.ts",
       "import": "./dist/cli/index.js"
+    },
+    "./cache": {
+      "types": "./dist/cache.d.ts",
+      "import": "./dist/cache.js"
     }
   },
   "files": [