honertia 0.1.37 → 0.1.40

package/README.md

@@ -824,7 +824,7 @@ export const listProjects = action(
         })
       ),
       S.Array(ProjectSchema),
-      Duration.minutes(5)
+      { ttl: Duration.minutes(5) }
     )
 
     return yield* render('Projects/Index', { projects: userProjects })
@@ -1676,7 +1676,7 @@ export const listProjects = action(
         catch: (error) => new Error(String(error)),
       }),
       S.Array(ProjectSchema),
-      Duration.minutes(5)
+      { ttl: Duration.minutes(5) }
     )
 
     return yield* render('Projects/Index', { projects: userProjects })
@@ -1688,12 +1688,19 @@ export const listProjects = action(
 
 | Function | Description |
 |----------|-------------|
-| `cache(key, compute, schema, ttl)` | Get from cache or compute and store |
+| `cache(key, compute, schema, options)` | 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 |
+| `cacheSet(key, value, schema, options)` | Store value in cache |
 | `cacheInvalidate(key)` | Delete a single cache key |
 | `cacheInvalidatePrefix(prefix)` | Delete all keys with prefix |
 
+The `options` parameter is an object with the following properties:
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `ttl` | `Duration.DurationInput` | Time-to-live for cached values (required) |
+| `swr` | `Duration.DurationInput` | Stale-while-revalidate window (optional) |
+
 ### Cache Invalidation
 
 Invalidate cache when data changes:
@@ -1783,7 +1790,7 @@ if (Option.isSome(cached)) {
 const user = yield* fetchUser(id)
 
 // Store in cache
-yield* cacheSet(`user:${id}`, user, UserSchema, Duration.hours(1))
+yield* cacheSet(`user:${id}`, user, UserSchema, { ttl: Duration.hours(1) })
 
 return user
 ```
@@ -1921,8 +1928,8 @@ describe('cache', () => {
         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))
+      const first = yield* cache('test:1', compute, TestSchema, { ttl: Duration.hours(1) })
+      const second = yield* cache('test:1', compute, TestSchema, { ttl: Duration.hours(1) })
 
       expect(first).toEqual(second)
       expect(callCount).toBe(1) // Only computed once
@@ -1937,9 +1944,9 @@ describe('cache', () => {
         return { id: '1', name: `Call ${callCount}` }
       })
 
-      yield* cache('test:1', compute, TestSchema, Duration.hours(1))
+      yield* cache('test:1', compute, TestSchema, { ttl: Duration.hours(1) })
       yield* cacheInvalidate('test:1')
-      yield* cache('test:1', compute, TestSchema, Duration.hours(1))
+      yield* cache('test:1', compute, TestSchema, { ttl: Duration.hours(1) })
 
       expect(callCount).toBe(2) // Computed twice
     }).pipe(Effect.provide(makeTestCache()), Effect.runPromise))
@@ -1979,6 +1986,410 @@ Recommended cache key patterns:
 `api:exchange:${currency}`
 ```
 
+### Stale-While-Revalidate (SWR)
+
+The cache supports the stale-while-revalidate pattern for improved latency and resilience. When enabled, stale values are returned immediately while a background refresh is triggered.
+
+```typescript
+import { Effect, Duration } from 'effect'
+import { cache, DatabaseService } from 'honertia/effect'
+
+const UserSchema = S.Struct({
+  id: S.String,
+  name: S.String,
+  email: S.String,
+})
+
+// Basic usage with TTL only
+const user = yield* cache(
+  `user:${id}`,
+  fetchUser(id),
+  UserSchema,
+  { ttl: Duration.hours(1) }
+)
+
+// With stale-while-revalidate
+const user = yield* cache(
+  `user:${id}`,
+  fetchUser(id),
+  UserSchema,
+  {
+    ttl: Duration.hours(1),      // Fresh for 1 hour
+    swr: Duration.minutes(5),    // Serve stale for 5 more minutes while refreshing
+  }
+)
+```
+
+**How SWR works:**
+
+| Cache State | Behavior |
+|-------------|----------|
+| Fresh (age < TTL) | Return cached value immediately |
+| Stale (TTL < age < TTL + SWR) | Return stale value immediately, trigger background refresh |
+| Expired (age > TTL + SWR) | Compute new value synchronously |
+| Cold (no cache) | Compute new value synchronously |
+
+**Benefits:**
+- **Faster responses**: Users always get an immediate response (stale or fresh)
+- **Reduced latency spikes**: No waiting for slow database queries during cache refresh
+- **Graceful degradation**: If the background refresh fails, stale data is still served
+
+**Real-world example:**
+
+```typescript
+import { Effect, Duration, Schema as S } from 'effect'
+import { action, authorize, cache, render, DatabaseService } from 'honertia/effect'
+import { eq } from 'drizzle-orm'
+import { projects } from '~/db/schema'
+
+const ProjectListSchema = S.Array(
+  S.Struct({
+    id: S.String,
+    name: S.String,
+    createdAt: S.Date,
+  })
+)
+
+export const indexProjects = action(
+  Effect.gen(function* () {
+    const auth = yield* authorize()
+    const db = yield* DatabaseService
+
+    // Cache project list with SWR
+    // - Fresh for 5 minutes
+    // - Serve stale for 1 additional minute while refreshing in background
+    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)],
+        })
+      ),
+      ProjectListSchema,
+      {
+        ttl: Duration.minutes(5),
+        swr: Duration.minutes(1),
+      }
+    )
+
+    return yield* render('Projects/Index', { projects: userProjects })
+  })
+)
+```
+
+### Background Tasks with ExecutionContextService
+
+The `ExecutionContextService` provides access to Cloudflare Workers' `waitUntil` API, allowing you to run tasks after the response is sent. This is automatically used by the cache's SWR feature for background refresh.
+
+```typescript
+import { Effect } from 'effect'
+import { action, ExecutionContextService, authorize, render } from 'honertia/effect'
+
+export const dashboard = action(
+  Effect.gen(function* () {
+    const auth = yield* authorize()
+    const ctx = yield* ExecutionContextService
+
+    // Send analytics in background - doesn't block response
+    yield* ctx.runInBackground(
+      Effect.tryPromise(() =>
+        fetch('https://analytics.example.com/events', {
+          method: 'POST',
+          body: JSON.stringify({
+            event: 'page_view',
+            userId: auth.user.id,
+            page: 'dashboard',
+            timestamp: Date.now(),
+          }),
+        })
+      )
+    )
+
+    return yield* render('Dashboard', { user: auth.user })
+  })
+)
+```
+
+**ExecutionContextService API:**
+
+| Method | Description |
+|--------|-------------|
+| `isAvailable` | `boolean` - Whether background execution is available |
+| `runInBackground(effect)` | Run an Effect after the response is sent |
+| `waitUntil(promise)` | Raw `waitUntil` for external promises |
+
+**Common use cases:**
+
+```typescript
+// Audit logging
+const auditLog = (action: string, details: Record<string, unknown>) =>
+  Effect.gen(function* () {
+    const ctx = yield* ExecutionContextService
+    const user = yield* authorize()
+    const db = yield* DatabaseService
+
+    yield* ctx.runInBackground(
+      Effect.tryPromise(() =>
+        db.insert(auditLogs).values({
+          userId: user.id,
+          action,
+          details,
+          timestamp: new Date(),
+        })
+      )
+    )
+  })
+
+// Webhook delivery with retries
+const deliverWebhook = (url: string, payload: unknown) =>
+  Effect.gen(function* () {
+    const ctx = yield* ExecutionContextService
+
+    yield* ctx.runInBackground(
+      Effect.tryPromise(() =>
+        fetch(url, {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify(payload),
+        })
+      ).pipe(
+        Effect.retry({ times: 3 }),
+        Effect.catchAll((error) =>
+          Effect.logError('Webhook delivery failed', { url, error })
+        )
+      )
+    )
+  })
+
+// Conditional background work
+const maybeNotifySlack = (message: string) =>
+  Effect.gen(function* () {
+    const ctx = yield* ExecutionContextService
+    const bindings = yield* BindingsService
+
+    // Only run if Slack is configured and background is available
+    if (bindings.SLACK_WEBHOOK_URL && ctx.isAvailable) {
+      yield* ctx.runInBackground(
+        Effect.tryPromise(() =>
+          fetch(bindings.SLACK_WEBHOOK_URL, {
+            method: 'POST',
+            body: JSON.stringify({ text: message }),
+          })
+        )
+      )
+    }
+  })
+```
+
+**Important notes:**
+- Background tasks run after the response is sent to the user
+- Errors in background tasks are logged but don't crash the worker
+- In non-Worker environments (tests, local dev), `isAvailable` is `false` and tasks are skipped
+- Use `catchAll` to handle errors gracefully in background tasks
+
+### Cache Key Versioning
+
+Cache versioning ensures cache correctness when your data schema changes. Without versioning, schema changes can cause decode errors or serve stale data with the wrong shape.
+
+**The Problem:**
+
+```typescript
+// Version 1 of your schema
+const UserSchemaV1 = S.Struct({
+  id: S.String,
+  name: S.String,
+  email: S.String,
+})
+
+// You deploy with cached data...
+
+// Version 2 adds a required field
+const UserSchemaV2 = S.Struct({
+  id: S.String,
+  name: S.String,
+  email: S.String,
+  avatar: S.String,  // New required field!
+})
+
+// Cached V1 data fails to decode with V2 schema → Runtime error
+```
+
+**Solution 1: Auto Schema Versioning (Recommended)**
+
+Pass `version: true` to automatically version cache keys based on a hash of the schema structure. When you change the schema, the hash changes, and old cached data is automatically bypassed.
+
+```typescript
+import { Effect, Duration, Schema as S } from 'effect'
+import { cache, DatabaseService } from 'honertia/effect'
+
+const UserSchema = S.Struct({
+  id: S.String,
+  name: S.String,
+  email: S.String,
+})
+
+// Cache key becomes "a1b2c3:user:123" (hash:key)
+const user = yield* cache(
+  `user:${id}`,
+  fetchUser(id),
+  UserSchema,
+  { ttl: Duration.hours(1), version: true }
+)
+```
+
+**When to use `version: true`:**
+- You want automatic cache invalidation when schemas evolve
+- You're iterating quickly on data structures during development
+- You want zero-downtime deployments without manual cache clearing
+
+**When NOT to use `version: true`:**
+- You need cache hits to survive deployments (use explicit versions instead)
+- Schema changes are intentionally backward-compatible
+- You're caching data that doesn't depend on schema structure
+
+**Solution 2: Explicit Version Strings**
+
+For more control, pass an explicit version string. Bump it manually when your schema changes.
+
+```typescript
+// Cache key becomes "v2:user:123"
+const user = yield* cache(
+  `user:${id}`,
+  fetchUser(id),
+  UserSchema,
+  { ttl: Duration.hours(1), version: 'v2' }
+)
+```
+
+**When to use explicit versions:**
+- You want cache hits to survive deployments
+- You need predictable cache keys for debugging
+- You're coordinating schema changes across services
+
+**Full Example: User Profile with Versioned Cache**
+
+```typescript
+import { Effect, Duration, Schema as S } from 'effect'
+import {
+  action,
+  authorize,
+  cache,
+  cacheInvalidate,
+  render,
+  redirect,
+  DatabaseService,
+  validateRequest,
+  dbMutation,
+} from 'honertia/effect'
+import { eq } from 'drizzle-orm'
+import { users } from '~/db/schema'
+
+// Schema definition - changing this auto-invalidates cache when version: true
+const UserProfileSchema = S.Struct({
+  id: S.String,
+  name: S.String,
+  email: S.String,
+  bio: S.NullOr(S.String),
+  avatarUrl: S.NullOr(S.String),
+})
+
+// GET /profile - cached with auto-versioning
+export const showProfile = action(
+  Effect.gen(function* () {
+    const auth = yield* authorize()
+    const db = yield* DatabaseService
+
+    const profile = yield* cache(
+      `user:profile:${auth.user.id}`,
+      Effect.tryPromise(() =>
+        db.query.users.findFirst({
+          where: eq(users.id, auth.user.id),
+          columns: { id: true, name: true, email: true, bio: true, avatarUrl: true },
+        })
+      ),
+      UserProfileSchema,
+      {
+        ttl: Duration.hours(1),
+        swr: Duration.minutes(5),
+        version: true,  // Auto-invalidates when UserProfileSchema changes
+      }
+    )
+
+    return yield* render('Profile/Show', { profile })
+  })
+)
+
+// PUT /profile - invalidate cache after update
+export const updateProfile = action(
+  Effect.gen(function* () {
+    const auth = yield* authorize()
+    const input = yield* validateRequest(UpdateProfileSchema, {
+      errorComponent: 'Profile/Edit',
+    })
+    const db = yield* DatabaseService
+
+    yield* dbMutation(db, async (db) => {
+      await db.update(users)
+        .set({ name: input.name, bio: input.bio })
+        .where(eq(users.id, auth.user.id))
+    })
+
+    // Invalidate with same versioning strategy
+    yield* cacheInvalidate(`user:profile:${auth.user.id}`, {
+      schema: UserProfileSchema,
+      version: true,
+    })
+
+    return yield* redirect('/profile')
+  })
+)
+```
+
+**Versioning with `cacheGet` and `cacheInvalidate`:**
+
+When using manual cache operations, pass the same version option:
+
+```typescript
+import { cacheGet, cacheSet, cacheInvalidate } from 'honertia/effect'
+
+// Get with auto-versioning
+const cached = yield* cacheGet(`user:${id}`, UserSchema, { version: true })
+
+// Set with explicit version
+yield* cacheSet(`user:${id}`, user, UserSchema, {
+  ttl: Duration.hours(1),
+  version: 'v2',
+})
+
+// Invalidate with versioning - requires schema when using version
+yield* cacheInvalidate(`user:${id}`, { schema: UserSchema, version: true })
+
+// Simple invalidation (no versioning)
+yield* cacheInvalidate(`user:${id}`)
+```
+
+**How Schema Hashing Works:**
+
+The auto-versioning feature uses the djb2 hash algorithm on the serialized schema AST:
+
+1. Schema structure is serialized to a string representation
+2. A fast, deterministic hash is computed (djb2)
+3. The hash is prepended to the cache key
+
+This means:
+- Same schema definition → same hash → cache hits work
+- Changed schema structure → different hash → cache miss, fresh data computed
+- Adding/removing fields, changing types, or modifying constraints all change the hash
+
+**Cache Options Reference:**
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `ttl` | `Duration.DurationInput` | Time-to-live for cached values (required) |
+| `swr` | `Duration.DurationInput` | Stale-while-revalidate window (optional) |
+| `version` | `string \| boolean` | `true` = auto schema hash, `string` = explicit prefix (optional) |
+
 ---
 
 ## Services Reference
@@ -1990,6 +2401,7 @@ Recommended cache key patterns:
 | `AuthUserService` | Current user session | `const user = yield* AuthUserService` |
 | `BindingsService` | Cloudflare bindings | `const { KV } = yield* BindingsService` |
 | `CacheService` | KV-backed cache client | `const cache = yield* CacheService` |
+| `ExecutionContextService` | Background task execution | `const ctx = yield* ExecutionContextService` |
 | `RequestService` | Request context | `const req = yield* RequestService` |
 
 ### Using BindingsService

package/dist/cache.d.ts

@@ -4,9 +4,36 @@
  * 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.
+ *
+ * Supports stale-while-revalidate (SWR) pattern for improved latency and resilience.
  */
 import { Effect, Option, Schema, ParseResult, Duration } from 'effect';
-import { CacheService, CacheClientError } from './effect/services.js';
+import { CacheService, CacheClientError, ExecutionContextService } from './effect/services.js';
+export type CacheOptions = {
+    /** Time-to-live for cached values */
+    ttl: Duration.DurationInput;
+    /**
+     * Stale-while-revalidate window. When set, stale values within this window
+     * are returned immediately while a background refresh is triggered.
+     * Without ExecutionContext, the refresh happens on the next request.
+     */
+    swr?: Duration.DurationInput;
+    /**
+     * Cache key versioning for safe schema migrations.
+     * - `string`: Explicit version prefix (e.g., 'v2')
+     * - `true`: Auto-generate version from schema hash
+     * - `false` or omitted: No versioning
+     */
+    version?: string | boolean;
+};
+export type CacheGetOptions = {
+    /**
+     * Cache key versioning (must match what was used when caching).
+     * - `string`: Explicit version prefix
+     * - `true`: Auto-generate version from schema hash
+     */
+    version?: string | boolean;
+};
 declare const CacheError_base: Schema.TaggedErrorClass<CacheError, "CacheError", {
     readonly _tag: Schema.tag<"CacheError">;
 } & {
@@ -17,18 +44,44 @@ export declare class CacheError extends CacheError_base {
 }
 /**
  * Cache a computed value with automatic serialization and TTL.
+ * Supports stale-while-revalidate (SWR) for improved latency.
  *
  * @example
  * ```typescript
+ * // Basic usage
  * const user = yield* cache(
  *   `user:${id}`,
  *   Effect.tryPromise(() => db.query.users.findFirst({ where: eq(users.id, id) })),
  *   UserSchema,
- *   Duration.hours(1)
+ *   { ttl: Duration.hours(1) }
+ * )
+ *
+ * // With stale-while-revalidate
+ * const user = yield* cache(
+ *   `user:${id}`,
+ *   fetchUser(id),
+ *   UserSchema,
+ *   { ttl: Duration.hours(1), swr: Duration.minutes(5) }
+ * )
+ *
+ * // With auto schema versioning (cache auto-invalidates when schema changes)
+ * const user = yield* cache(
+ *   `user:${id}`,
+ *   fetchUser(id),
+ *   UserSchema,
+ *   { ttl: Duration.hours(1), version: true }
+ * )
+ *
+ * // With explicit version
+ * const user = yield* cache(
+ *   `user:${id}`,
+ *   fetchUser(id),
+ *   UserSchema,
+ *   { ttl: Duration.hours(1), version: 'v2' }
  * )
  * ```
  */
-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>;
+export declare const cache: <V, E, R>(key: string, compute: Effect.Effect<V, E, R>, schema: Schema.Schema<V>, options: CacheOptions) => Effect.Effect<V, E | CacheError | CacheClientError | ParseResult.ParseError, R | CacheService | ExecutionContextService>;
 /**
  * Get a value from cache without computing.
  *
@@ -38,27 +91,43 @@ export declare const cache: <V, E, R>(key: string, compute: Effect.Effect<V, E,
  * if (Option.isSome(cached)) {
  *   return cached.value
  * }
+ *
+ * // With versioning (must match what was used when caching)
+ * const cached = yield* cacheGet(`user:${id}`, UserSchema, { version: true })
  * ```
  */
-export declare const cacheGet: <V>(key: string, schema: Schema.Schema<V>) => Effect.Effect<Option.Option<V>, CacheError | CacheClientError | ParseResult.ParseError, CacheService>;
+export declare const cacheGet: <V>(key: string, schema: Schema.Schema<V>, options?: CacheGetOptions) => 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))
+ * yield* cacheSet(`user:${id}`, user, UserSchema, { ttl: Duration.hours(1) })
+ *
+ * // With auto schema versioning
+ * yield* cacheSet(`user:${id}`, user, UserSchema, { ttl: Duration.hours(1), version: true })
  * ```
  */
-export declare const cacheSet: <V>(key: string, value: V, schema: Schema.Schema<V>, ttl: Duration.DurationInput) => Effect.Effect<void, CacheError | CacheClientError | ParseResult.ParseError, CacheService>;
+export declare const cacheSet: <V>(key: string, value: V, schema: Schema.Schema<V>, options: CacheOptions) => Effect.Effect<void, CacheError | CacheClientError | ParseResult.ParseError, CacheService>;
+export type CacheInvalidateOptions<V> = {
+    /** Schema used when caching (required if version is set) */
+    schema: Schema.Schema<V>;
+    /** Version option (must match what was used when caching) */
+    version: string | boolean;
+};
 /**
  * Invalidate a cache key.
  *
  * @example
  * ```typescript
+ * // Simple invalidation
  * yield* cacheInvalidate(`user:${id}`)
+ *
+ * // Invalidate versioned key
+ * yield* cacheInvalidate(`user:${id}`, { schema: UserSchema, version: true })
  * ```
  */
-export declare const cacheInvalidate: (key: string) => Effect.Effect<void, CacheClientError, CacheService>;
+export declare const cacheInvalidate: <V = unknown>(key: string, options?: CacheInvalidateOptions<V>) => Effect.Effect<void, CacheClientError, CacheService>;
 /**
  * Invalidate all cache keys with a given prefix.
  *

package/dist/cache.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AACtE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAM9F,MAAM,MAAM,YAAY,GAAG;IACzB,qCAAqC;IACrC,GAAG,EAAE,QAAQ,CAAC,aAAa,CAAA;IAC3B;;;;OAIG;IACH,GAAG,CAAC,EAAE,QAAQ,CAAC,aAAa,CAAA;IAC5B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAC3B,CAAA;;;;;;;AAMD,qBAAa,UAAW,SAAQ,eAG9B;CAAG;AA2DL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;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,SAAS,YAAY,KACpB,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,UAAU,GAAG,gBAAgB,GAAG,WAAW,CAAC,UAAU,EAAE,CAAC,GAAG,YAAY,GAAG,uBAAuB,CAuDtH,CAAA;AAEJ;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,EACxB,KAAK,MAAM,EACX,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EACxB,UAAU,eAAe,KACxB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,GAAG,gBAAgB,GAAG,WAAW,CAAC,UAAU,EAAE,YAAY,CAenG,CAAA;AAEJ;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,EACxB,KAAK,MAAM,EACX,OAAO,CAAC,EACR,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EACxB,SAAS,YAAY,KACpB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,gBAAgB,GAAG,WAAW,CAAC,UAAU,EAAE,YAAY,CAevF,CAAA;AAEJ,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI;IACtC,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;IACxB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,GAAG,OAAO,CAAA;CAC1B,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,GAAG,OAAO,EACzC,KAAK,MAAM,EACX,UAAU,sBAAsB,CAAC,CAAC,CAAC,KAClC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,EAAE,YAAY,CAOjD,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

@@ -4,9 +4,11 @@
  * 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.
+ *
+ * Supports stale-while-revalidate (SWR) pattern for improved latency and resilience.
  */
 import { Effect, Option, Schema, Duration } from 'effect';
-import { CacheService } from './effect/services.js';
+import { CacheService, ExecutionContextService } from './effect/services.js';
 // ============================================================================
 // Errors
 // ============================================================================
@@ -16,34 +18,128 @@ export class CacheError extends Schema.TaggedError()('CacheError', {
 }) {
 }
 // ============================================================================
+// Internal
+// ============================================================================
+/** Internal schema for storing value with metadata */
+const CacheEntrySchema = (valueSchema) => Schema.Struct({
+    v: valueSchema,
+    t: Schema.Number, // cachedAt timestamp
+});
+/**
+ * Simple string hash function (djb2 algorithm).
+ * Produces a short, deterministic hash for cache key versioning.
+ */
+const hashString = (str) => {
+    let hash = 5381;
+    for (let i = 0; i < str.length; i++) {
+        hash = ((hash << 5) + hash) ^ str.charCodeAt(i);
+    }
+    // Convert to unsigned 32-bit and then to base36 for short strings
+    return (hash >>> 0).toString(36);
+};
+/**
+ * Generate a version string from a schema's AST.
+ * The hash changes when the schema structure changes.
+ */
+const hashSchema = (schema) => {
+    // Stringify the AST - this captures the schema structure
+    const astString = JSON.stringify(schema.ast);
+    return hashString(astString);
+};
+/**
+ * Resolve the effective cache key with optional versioning.
+ */
+const resolveKey = (key, schema, version) => {
+    if (version === true) {
+        return `${hashSchema(schema)}:${key}`;
+    }
+    if (typeof version === 'string') {
+        return `${version}:${key}`;
+    }
+    return key;
+};
+// ============================================================================
 // Composable API
 // ============================================================================
 /**
  * Cache a computed value with automatic serialization and TTL.
+ * Supports stale-while-revalidate (SWR) for improved latency.
  *
  * @example
  * ```typescript
+ * // Basic usage
  * const user = yield* cache(
  *   `user:${id}`,
  *   Effect.tryPromise(() => db.query.users.findFirst({ where: eq(users.id, id) })),
  *   UserSchema,
- *   Duration.hours(1)
+ *   { ttl: Duration.hours(1) }
+ * )
+ *
+ * // With stale-while-revalidate
+ * const user = yield* cache(
+ *   `user:${id}`,
+ *   fetchUser(id),
+ *   UserSchema,
+ *   { ttl: Duration.hours(1), swr: Duration.minutes(5) }
+ * )
+ *
+ * // With auto schema versioning (cache auto-invalidates when schema changes)
+ * const user = yield* cache(
+ *   `user:${id}`,
+ *   fetchUser(id),
+ *   UserSchema,
+ *   { ttl: Duration.hours(1), version: true }
+ * )
+ *
+ * // With explicit version
+ * const user = yield* cache(
+ *   `user:${id}`,
+ *   fetchUser(id),
+ *   UserSchema,
+ *   { ttl: Duration.hours(1), version: 'v2' }
  * )
  * ```
  */
-export const cache = (key, compute, schema, ttl) => Effect.gen(function* () {
+export const cache = (key, compute, schema, options) => Effect.gen(function* () {
     const cacheService = yield* CacheService;
+    const executionContext = yield* ExecutionContextService;
+    const entrySchema = CacheEntrySchema(schema);
+    const jsonSchema = Schema.parseJson(entrySchema);
+    const effectiveKey = resolveKey(key, schema, options.version);
+    const ttlMs = Duration.toMillis(Duration.decode(options.ttl));
+    const swrMs = options.swr ? Duration.toMillis(Duration.decode(options.swr)) : 0;
+    const totalTtlSeconds = Math.ceil((ttlMs + swrMs) / 1000);
+    // Helper to store a value in cache
+    const storeInCache = (value) => Effect.gen(function* () {
+        const newEntry = { v: value, t: Date.now() };
+        const serialized = yield* Schema.encode(jsonSchema)(newEntry);
+        yield* cacheService.put(effectiveKey, serialized, { expirationTtl: totalTtlSeconds });
+    });
     // Check cache first
-    const cached = yield* cacheService.get(key);
+    const cached = yield* cacheService.get(effectiveKey);
     if (cached !== null) {
-        return yield* Schema.decodeUnknown(Schema.parseJson(schema))(cached);
+        const entry = yield* Schema.decodeUnknown(jsonSchema)(cached);
+        const age = Date.now() - entry.t;
+        if (age < ttlMs) {
+            // Fresh - return immediately
+            return entry.v;
+        }
+        if (swrMs > 0 && age < ttlMs + swrMs) {
+            // Stale but within SWR window - return stale, trigger background refresh
+            if (executionContext.isAvailable) {
+                yield* executionContext.runInBackground(Effect.gen(function* () {
+                    const freshValue = yield* compute;
+                    yield* storeInCache(freshValue);
+                }));
+            }
+            return entry.v;
+        }
+        // Beyond SWR window - fall through to recompute
     }
-    // Compute value
+    // Compute value (cold cache or expired)
     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 });
+    // Store with timestamp
+    yield* storeInCache(value);
     return value;
 });
 /**
@@ -55,42 +151,64 @@ export const cache = (key, compute, schema, ttl) => Effect.gen(function* () {
  * if (Option.isSome(cached)) {
  *   return cached.value
  * }
+ *
+ * // With versioning (must match what was used when caching)
+ * const cached = yield* cacheGet(`user:${id}`, UserSchema, { version: true })
  * ```
  */
-export const cacheGet = (key, schema) => Effect.gen(function* () {
+export const cacheGet = (key, schema, options) => Effect.gen(function* () {
     const cacheService = yield* CacheService;
-    const cached = yield* cacheService.get(key);
+    const entrySchema = CacheEntrySchema(schema);
+    const jsonSchema = Schema.parseJson(entrySchema);
+    const effectiveKey = resolveKey(key, schema, options?.version);
+    const cached = yield* cacheService.get(effectiveKey);
     if (cached === null) {
         return Option.none();
     }
-    const decoded = yield* Schema.decodeUnknown(Schema.parseJson(schema))(cached);
-    return Option.some(decoded);
+    const entry = yield* Schema.decodeUnknown(jsonSchema)(cached);
+    return Option.some(entry.v);
 });
 /**
  * Set a value in cache.
  *
  * @example
  * ```typescript
- * yield* cacheSet(`user:${id}`, user, UserSchema, Duration.hours(1))
+ * yield* cacheSet(`user:${id}`, user, UserSchema, { ttl: Duration.hours(1) })
+ *
+ * // With auto schema versioning
+ * yield* cacheSet(`user:${id}`, user, UserSchema, { ttl: Duration.hours(1), version: true })
  * ```
  */
-export const cacheSet = (key, value, schema, ttl) => Effect.gen(function* () {
+export const cacheSet = (key, value, schema, options) => 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 });
+    const entrySchema = CacheEntrySchema(schema);
+    const jsonSchema = Schema.parseJson(entrySchema);
+    const effectiveKey = resolveKey(key, schema, options.version);
+    const ttlMs = Duration.toMillis(Duration.decode(options.ttl));
+    const swrMs = options.swr ? Duration.toMillis(Duration.decode(options.swr)) : 0;
+    const totalTtlSeconds = Math.ceil((ttlMs + swrMs) / 1000);
+    const entry = { v: value, t: Date.now() };
+    const serialized = yield* Schema.encode(jsonSchema)(entry);
+    yield* cacheService.put(effectiveKey, serialized, { expirationTtl: totalTtlSeconds });
 });
 /**
  * Invalidate a cache key.
  *
  * @example
  * ```typescript
+ * // Simple invalidation
  * yield* cacheInvalidate(`user:${id}`)
+ *
+ * // Invalidate versioned key
+ * yield* cacheInvalidate(`user:${id}`, { schema: UserSchema, version: true })
  * ```
  */
-export const cacheInvalidate = (key) => Effect.gen(function* () {
+export const cacheInvalidate = (key, options) => Effect.gen(function* () {
     const cacheService = yield* CacheService;
-    yield* cacheService.delete(key);
+    const effectiveKey = options
+        ? resolveKey(key, options.schema, options.version)
+        : key;
+    yield* cacheService.delete(effectiveKey);
 });
 /**
  * Invalidate all cache keys with a given prefix.

package/dist/effect/auth.d.ts

@@ -5,7 +5,7 @@
  */
 import { Effect, Layer, Schema as S } from 'effect';
 import type { Hono, MiddlewareHandler, Env } from 'hono';
-import { AuthUserService, AuthService, HonertiaService, RequestService, type AuthUser } from './services.js';
+import { AuthUserService, AuthService, DatabaseService, HonertiaService, RequestService, type AuthUser } from './services.js';
 import { UnauthorizedError, ValidationError } from './errors.js';
 import { type EffectHandler } from './routing.js';
 /**
@@ -102,7 +102,7 @@ export declare function shareAuthMiddleware<E extends Env>(): MiddlewareHandler<
  * that's what the factory functions (betterAuthFormAction, betterAuthLogoutAction)
  * return, and effectAuthRoutes provides these services automatically.
  */
-export type AuthActionEffect<R = RequestService | AuthService, E extends Error = Error> = EffectHandler<R, E>;
+export type AuthActionEffect<R = RequestService | AuthService | DatabaseService, E extends Error = Error> = EffectHandler<R, E>;
 /**
  * Configuration for auth routes.
  */

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

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

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, CacheService } from './services.js';
+import { DatabaseService, AuthService, AuthUserService, HonertiaService, RequestService, ResponseFactoryService, BindingsService, CacheService, ExecutionContextService } 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 | CacheService | 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 | ExecutionContextService | 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,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"}
+{"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,EAEZ,uBAAuB,EAUxB,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;AA0JD;;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,uBAAuB,GACvB,cAAc,EAChB,KAAK,EACL,KAAK,CACN,CA8FA;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, CacheService, CacheClientError, } from './services.js';
+import { DatabaseService, AuthService, AuthUserService, HonertiaService, RequestService, ResponseFactoryService, BindingsService, CacheService, CacheClientError, ExecutionContextService, } from './services.js';
 import { TestCaptureService } from './test-layers.js';
 /**
  * Symbol for storing Effect runtime in Hono context.
@@ -123,6 +123,35 @@ function createUnconfiguredCacheClient() {
         list: () => Effect.fail(error),
     };
 }
+/**
+ * Create an ExecutionContextClient from Cloudflare's ExecutionContext.
+ */
+function createExecutionContextClient(ctx) {
+    return {
+        isAvailable: true,
+        waitUntil: (promise) => ctx.waitUntil(promise),
+        runInBackground: (effect) => Effect.flatMap(Effect.context(), (context) => Effect.sync(() => {
+            const promise = Effect.runPromise(effect.pipe(Effect.provide(context), Effect.catchAllCause((cause) => {
+                // Log errors but don't crash - this is background work
+                console.error('[Background Task Error]', cause);
+                return Effect.void;
+            })));
+            ctx.waitUntil(promise);
+        })),
+    };
+}
+/**
+ * Create a no-op ExecutionContextClient for environments without ExecutionContext.
+ */
+function createNoopExecutionContextClient() {
+    return {
+        isAvailable: false,
+        waitUntil: () => {
+            // No-op - silently ignore in non-Worker environments
+        },
+        runInBackground: () => Effect.void,
+    };
+}
 /**
  * Create a HonertiaRenderer from Hono context.
  */
@@ -161,7 +190,19 @@ 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, cacheLayer, databaseLayer, authLayer);
+    // ExecutionContext layer - for background task execution
+    // Note: Hono's executionCtx getter throws in non-Worker environments, so we wrap in try/catch
+    let executionCtx;
+    try {
+        executionCtx = c.executionCtx;
+    }
+    catch {
+        executionCtx = undefined;
+    }
+    const executionContextLayer = Layer.succeed(ExecutionContextService, executionCtx
+        ? createExecutionContextClient(executionCtx)
+        : createNoopExecutionContextClient());
+    let baseLayer = Layer.mergeAll(requestLayer, responseLayer, honertiaLayer, bindingsLayer, cacheLayer, databaseLayer, authLayer, executionContextLayer);
     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, CacheService, CacheClientError, authorize, type AuthUser, type EmailClient, type HonertiaRenderer, type RequestContext, type ResponseFactory, type CacheClient, type HonertiaDatabaseType, type HonertiaAuthType, type HonertiaBindingsType, type HonertiaAuthUserType, type DefaultAuthUser, type DatabaseType, type SchemaType, type AuthType, type BindingsType, } from './services.js';
+export { DatabaseService, AuthService, AuthUserService, EmailService, HonertiaService, RequestService, ResponseFactoryService, BindingsService, CacheService, CacheClientError, ExecutionContextService, authorize, type AuthUser, type EmailClient, type HonertiaRenderer, type RequestContext, type ResponseFactory, type CacheClient, type ExecutionContextClient, type HonertiaDatabaseType, type HonertiaAuthType, type HonertiaBindingsType, type HonertiaAuthUserType, type DefaultAuthUser, 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,6 +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 { CacheError, cache, cacheGet, cacheSet, cacheInvalidate, cacheInvalidatePrefix, type CacheOptions, type CacheGetOptions, type CacheInvalidateOptions, } from '../cache.js';
 export { RequireAuthLayer, RequireGuestLayer, createGuestLayer, 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, CacheService, CacheClientError, authorize, } from './services.js';
+export { DatabaseService, AuthService, AuthUserService, EmailService, HonertiaService, RequestService, ResponseFactoryService, BindingsService, CacheService, CacheClientError, ExecutionContextService, authorize, } from './services.js';
 // Errors
 export { ValidationError, UnauthorizedError, NotFoundError, ForbiddenError, HttpError, RouteConfigurationError, HonertiaConfigurationError, Redirect, isStructuredError, toStructuredError, } from './errors.js';
 // Error Catalog

package/dist/effect/services.d.ts

@@ -288,6 +288,70 @@ export declare class CacheClientError {
 declare const CacheService_base: Context.TagClass<CacheService, "honertia/Cache", CacheClient>;
 export declare class CacheService extends CacheService_base {
 }
+/**
+ * Client interface for background execution.
+ * Wraps Cloudflare's ExecutionContext with Effect-native methods.
+ *
+ * @example
+ * ```typescript
+ * const ctx = yield* ExecutionContextService
+ *
+ * // Effect-native: run an Effect in the background
+ * yield* ctx.runInBackground(
+ *   sendAnalyticsEvent({ userId, page: 'dashboard' })
+ * )
+ *
+ * // Raw API: for promises from external libraries
+ * ctx.waitUntil(externalLib.doSomething())
+ *
+ * // Check availability before optional background work
+ * if (ctx.isAvailable) {
+ *   yield* ctx.runInBackground(touchSession())
+ * }
+ * ```
+ */
+export interface ExecutionContextClient {
+    /**
+     * Whether background execution is available.
+     * False in tests or non-Worker environments.
+     */
+    readonly isAvailable: boolean;
+    /**
+     * Run an Effect in the background after the response is sent.
+     * Errors are caught and logged - they won't crash the worker.
+     *
+     * The Effect's requirements (R) must be satisfied by the current context.
+     * Returns immediately - the actual work happens asynchronously.
+     */
+    runInBackground: <A, E, R>(effect: Effect.Effect<A, E, R>) => Effect.Effect<void, never, R>;
+    /**
+     * Raw waitUntil - extends worker lifetime for a Promise.
+     * Use this for promises from external libraries.
+     * No-op if background execution is unavailable.
+     */
+    waitUntil: (promise: Promise<unknown>) => void;
+}
+declare const ExecutionContextService_base: Context.TagClass<ExecutionContextService, "honertia/ExecutionContext", ExecutionContextClient>;
+/**
+ * Execution Context Service - Background task execution for Cloudflare Workers.
+ *
+ * Automatically provided by the Effect bridge. Uses Cloudflare's `waitUntil`
+ * to run work after the response is sent.
+ *
+ * @example
+ * ```typescript
+ * // In an action - send analytics without blocking response
+ * const ctx = yield* ExecutionContextService
+ * yield* ctx.runInBackground(
+ *   Effect.tryPromise(() => fetch('https://analytics.example.com/events', {
+ *     method: 'POST',
+ *     body: JSON.stringify({ event: 'page_view', userId })
+ *   }))
+ * )
+ * ```
+ */
+export declare class ExecutionContextService extends ExecutionContextService_base {
+}
 /**
  * Authorization helper - opt-in to auth check.
  *

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":"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"}

package/dist/effect/services.js

@@ -66,6 +66,26 @@ export class CacheClientError {
 }
 export class CacheService extends Context.Tag('honertia/Cache')() {
 }
+/**
+ * Execution Context Service - Background task execution for Cloudflare Workers.
+ *
+ * Automatically provided by the Effect bridge. Uses Cloudflare's `waitUntil`
+ * to run work after the response is sent.
+ *
+ * @example
+ * ```typescript
+ * // In an action - send analytics without blocking response
+ * const ctx = yield* ExecutionContextService
+ * yield* ctx.runInBackground(
+ *   Effect.tryPromise(() => fetch('https://analytics.example.com/events', {
+ *     method: 'POST',
+ *     body: JSON.stringify({ event: 'page_view', userId })
+ *   }))
+ * )
+ * ```
+ */
+export class ExecutionContextService extends Context.Tag('honertia/ExecutionContext')() {
+}
 /**
  * Authorization helper - opt-in to auth check.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "honertia",
-  "version": "0.1.37",
+  "version": "0.1.40",
   "description": "Inertia.js-style server-driven SPA adapter for Hono",
   "type": "module",
   "main": "./dist/index.js",