honertia 0.1.16 → 0.1.18

package/README.md

@@ -84,18 +84,7 @@ class BindingsService extends Context.Tag('app/Bindings')<
   { KV: KVNamespace }
 >() {}
 
-// Request-scoped setup: put db/auth on c.var so Honertia/Effect can read them.
-app.use('*', async (c, next) => {
-  c.set('db', createDb(c.env.DATABASE_URL))
-  c.set('auth', createAuth({
-    db: c.var.db,
-    secret: c.env.BETTER_AUTH_SECRET,
-    baseURL: new URL(c.req.url).origin,
-  }))
-  await next()
-})
-
-// Honertia bundles the core middleware + auth loading + Effect runtime setup.
+// Honertia bundles db/auth setup + core middleware + Effect runtime.
 app.use('*', setupHonertia<Env, BindingsService>({
   honertia: {
     // Use your asset manifest hash so Inertia reloads on deploy.
@@ -109,9 +98,19 @@ app.use('*', setupHonertia<Env, BindingsService>({
         head: isProd ? '' : vite.hmrHead(),
       }
     }),
+    // Database factory (creates c.var.db for each request)
+    database: (c) => createDb(c.env.DATABASE_URL),
+    // Auth factory (can access c.var.db since database runs first)
+    auth: (c) => createAuth({
+      db: c.var.db,
+      secret: c.env.BETTER_AUTH_SECRET,
+      baseURL: new URL(c.req.url).origin,
+    }),
+    // Schema for route model binding (optional)
+    schema,
   },
   effect: {
-    // Expose Cloudflare bindings to Effect handlers via a service layer.
+    // Custom Effect services (e.g., Cloudflare bindings)
     services: (c) => Layer.succeed(BindingsService, {
       KV: c.env.MY_KV,
     }),
@@ -119,7 +118,6 @@ app.use('*', setupHonertia<Env, BindingsService>({
   // Optional: extra Hono middleware in the same chain.
   middleware: [
     logger(),
-    // register additional middleware here...
   ],
 }))
 
@@ -963,13 +961,19 @@ declare module 'honertia/effect' {
 }
 ```
 
-2. Pass your schema to `effectRoutes`:
+2. Pass your schema to `setupHonertia`:
 
 ```typescript
 import * as schema from '~/db/schema'
 
-effectRoutes(app, { schema })
-  .get('/projects/{project}', showProject)
+app.use('*', setupHonertia({
+  honertia: {
+    version: '1.0.0',
+    render: createTemplate({ ... }),
+    database: (c) => createDb(c.env.DATABASE_URL),
+    schema,  // Schema is shared with all effectRoutes
+  },
+}))
 ```
 
 **Basic Usage:**
@@ -980,7 +984,7 @@ import { bound } from 'honertia/effect'
 // Route: /projects/{project}
 // Automatically queries: SELECT * FROM projects WHERE id = :project
 
-effectRoutes(app, { schema }).get('/projects/{project}', showProject)
+effectRoutes(app).get('/projects/{project}', showProject)
 
 const showProject = Effect.gen(function* () {
   const project = yield* bound('project')  // Already fetched, guaranteed to exist
@@ -994,7 +998,7 @@ By default, bindings query the `id` column. Use `{param:column}` syntax to bind
 
 ```typescript
 // Bind by slug instead of id
-effectRoutes(app, { schema }).get('/projects/{project:slug}', showProject)
+effectRoutes(app).get('/projects/{project:slug}', showProject)
 // Queries: SELECT * FROM projects WHERE slug = :project
 ```
 
@@ -1004,7 +1008,7 @@ For nested routes, Honertia automatically scopes child models to their parents u
 
 ```typescript
 // Route: /users/{user}/posts/{post}
-effectRoutes(app, { schema }).get('/users/{user}/posts/{post}', showUserPost)
+effectRoutes(app).get('/users/{user}/posts/{post}', showUserPost)
 
 // Queries:
 // 1. SELECT * FROM users WHERE id = :user
@@ -1039,7 +1043,7 @@ If no relation is found, the child is resolved without scoping (useful for unrel
 Route model binding and param validation work together. Validation runs first:
 
 ```typescript
-effectRoutes(app, { schema }).get(
+effectRoutes(app).get(
   '/projects/{project}',
   showProject,
   { params: S.Struct({ project: uuid }) }  // Validates UUID format first
@@ -1058,7 +1062,7 @@ You can mix Laravel-style `{binding}` with Hono-style `:param` in the same route
 ```typescript
 // :version is a regular Hono param (not bound)
 // {project} is resolved from the database
-effectRoutes(app, { schema }).get(
+effectRoutes(app).get(
   '/api/:version/projects/{project}',
   showProject
 )
@@ -1243,7 +1247,204 @@ return yield* forbidden('You cannot edit this project')
 
 ## Error Handling
 
-Honertia provides typed errors:
+Honertia provides typed errors that integrate with Effect's error channel. Each error type has specific handling behavior designed for Inertia-style applications.
+
+### Built-in Error Types
+
+| Error Type | HTTP Status | Handling Behavior |
+|------------|-------------|-------------------|
+| `ValidationError` | 422 / redirect | Re-renders form with field errors, or redirects back |
+| `UnauthorizedError` | 302/303 | Redirects to login page |
+| `NotFoundError` | 404 | Uses Hono's `notFound()` handler → renders via Honertia |
+| `ForbiddenError` | 403 | Returns JSON response (for API compatibility) |
+| `HttpError` | Custom | Returns JSON with custom status (developer-controlled) |
+| `RouteConfigurationError` | 500 | Throws to Hono's `onError` → renders error page |
+| Unexpected errors | 500 | Throws to Hono's `onError` → renders error page |
+
+### Error Type Details
+
+#### `ValidationError`
+
+Thrown when request validation fails. Automatically re-renders the form with field-level errors.
+
+```typescript
+import { ValidationError, validateRequest } from 'honertia/effect'
+
+// Automatic: validateRequest throws ValidationError on failure
+const input = yield* validateRequest(schema, {
+  errorComponent: 'Projects/Create', // Re-renders this component with errors
+})
+
+// Manual: throw ValidationError directly
+yield* Effect.fail(new ValidationError({
+  errors: { email: 'Invalid email format' },
+  component: 'Auth/Register', // Optional: component to re-render
+}))
+```
+
+**Behavior:**
+- If request prefers JSON (API calls): returns `{ errors: {...} }` with 422 status
+- If `component` is set: re-renders that component with errors in props
+- Otherwise: redirects back to referer with errors in session
+
+#### `UnauthorizedError`
+
+Thrown when authentication is required but the user is not logged in.
+
+```typescript
+import { UnauthorizedError, authorize } from 'honertia/effect'
+
+// Automatic: authorize() throws UnauthorizedError if no user
+const auth = yield* authorize()
+
+// Manual: throw with custom redirect
+yield* Effect.fail(new UnauthorizedError({
+  message: 'Please log in to continue',
+  redirectTo: '/login', // Defaults to '/login'
+}))
+```
+
+**Behavior:** Redirects to the specified URL (302 for regular requests, 303 for Inertia requests).
+
+#### `NotFoundError`
+
+Thrown when a requested resource doesn't exist.
+
+```typescript
+import { NotFoundError, notFound } from 'honertia/effect'
+
+// Helper function
+return yield* notFound('Project', projectId)
+
+// Manual
+yield* Effect.fail(new NotFoundError({
+  resource: 'Project',
+  id: projectId,
+}))
+```
+
+**Behavior:** Triggers Hono's `notFound()` handler. If you've set up `registerErrorHandlers()`, this renders your error component with status 404.
+
+#### `ForbiddenError`
+
+Thrown when the user is authenticated but not authorized to perform an action.
+
+```typescript
+import { ForbiddenError, forbidden, authorize } from 'honertia/effect'
+
+// Automatic: authorize() throws ForbiddenError if check fails
+const auth = yield* authorize((a) => a.user.role === 'admin')
+
+// Helper function
+return yield* forbidden('You cannot edit this project')
+
+// Manual
+yield* Effect.fail(new ForbiddenError({
+  message: 'Admin access required',
+}))
+```
+
+**Behavior:** Returns JSON `{ message: "..." }` with 403 status. This is intentionally JSON for API compatibility.
+
+#### `HttpError`
+
+A generic error for custom HTTP responses. Use when you need precise control over the response.
+
+```typescript
+import { HttpError, httpError } from 'honertia/effect'
+
+// Helper function
+return yield* httpError(429, 'Rate limited', { retryAfter: 60 })
+
+// Manual
+yield* Effect.fail(new HttpError({
+  status: 429,
+  message: 'Too many requests',
+  body: { retryAfter: 60 }, // Optional additional data
+}))
+```
+
+**Behavior:** Returns JSON `{ message: "...", ...body }` with the specified status code.
+
+#### `RouteConfigurationError`
+
+Thrown when there's a developer configuration error, such as using route model binding without providing a schema.
+
+```typescript
+import { RouteConfigurationError } from 'honertia/effect'
+
+// This error is thrown automatically when:
+// - You use bound('project') but didn't pass schema to effectRoutes()
+// - Other route configuration mistakes
+
+// You typically don't throw this manually
+```
+
+**Behavior:** Re-throws to Hono's `onError` handler, which renders your error component. The error message and hint are logged to the console for debugging.
+
+### Setting Up Error Pages
+
+To render errors via Honertia instead of returning plain text/JSON, use `registerErrorHandlers`:
+
+```typescript
+import { registerErrorHandlers } from 'honertia'
+
+// In your app setup
+registerErrorHandlers(app, {
+  component: 'Error',        // Your error page component
+  showDevErrors: true,       // Show detailed errors in development
+  envKey: 'ENVIRONMENT',     // Env var to check
+  devValue: 'development',   // Value that enables dev errors
+})
+```
+
+Your `Error` component receives:
+
+```tsx
+// src/pages/Error.tsx
+interface ErrorProps {
+  status: number    // 404, 500, etc.
+  message: string   // Error message (detailed in dev, generic in prod)
+}
+
+export default function Error({ status, message }: ErrorProps) {
+  return (
+    <div className="error-page">
+      <h1>{status}</h1>
+      <p>{message}</p>
+    </div>
+  )
+}
+```
+
+### Error Handling Flow
+
+```
+Effect Handler
+     │
+     ▼
+┌─────────────────────────────────────────────────────────┐
+│                    errorToResponse()                     │
+├─────────────────────────────────────────────────────────┤
+│ ValidationError  → Re-render form / redirect back       │
+│ UnauthorizedError → Redirect to login                   │
+│ NotFoundError    → c.notFound() → Hono notFound handler │
+│ ForbiddenError   → JSON 403                             │
+│ HttpError        → JSON with custom status              │
+│ Other errors     → throw → Hono onError handler         │
+└─────────────────────────────────────────────────────────┘
+                           │
+                           ▼ (for thrown errors)
+┌─────────────────────────────────────────────────────────┐
+│              Hono onError handler                        │
+│         (from registerErrorHandlers)                     │
+├─────────────────────────────────────────────────────────┤
+│ Renders error component via Honertia                    │
+│ Shows detailed message in dev, generic in prod          │
+└─────────────────────────────────────────────────────────┘
+```
+
+### Usage Examples
 
 ```typescript
 import {
@@ -1252,7 +1453,7 @@ import {
   NotFoundError,
   ForbiddenError,
   HttpError,
-} from 'honertia'
+} from 'honertia/effect'
 
 // Validation errors automatically re-render with field errors
 const input = yield* validateRequest(schema, {

package/dist/effect/binding.js

@@ -65,7 +65,7 @@ export const bound = (key) => Effect.gen(function* () {
     if (models.has('__schema_not_configured__')) {
         return yield* new RouteConfigurationError({
             message: `Route model binding requires schema configuration. Cannot resolve bound('${key}') without schema.`,
-            hint: `Pass your schema to effectRoutes: effectRoutes(app, { schema })`
+            hint: `Pass your schema to setupHonertia: setupHonertia({ honertia: { schema } })`
         });
     }
     const model = models.get(key);

package/dist/effect/bridge.d.ts

@@ -15,7 +15,6 @@ import { DatabaseService, AuthService, AuthUserService, HonertiaService, Request
  * @example
  * // Provide Cloudflare Worker bindings as a service
  * effectBridge<Env, BindingsService>({
- *   database: (c) => createDb(c.env.DATABASE_URL),
  *   services: (c) => Layer.succeed(BindingsService, c.env),
  * })
  *
@@ -29,7 +28,6 @@ import { DatabaseService, AuthService, AuthUserService, HonertiaService, Request
  * })
  */
 export interface EffectBridgeConfig<E extends Env, CustomServices = never> {
-    database?: (c: HonoContext<E>) => unknown;
     /**
      * Custom services to provide to all Effect handlers.
      * Return a Layer that provides your custom services.
@@ -37,14 +35,8 @@ export interface EffectBridgeConfig<E extends Env, CustomServices = never> {
     services?: (c: HonoContext<E>) => Layer.Layer<CustomServices, never, never>;
     /**
      * Drizzle schema for route model binding.
-     * Required if using Laravel-style route model binding.
-     *
-     * @example
-     * ```typescript
-     * import * as schema from '~/db/schema'
-     *
-     * effectRoutes(app, { schema })
-     * ```
+     * Usually configured via `setupHonertia({ honertia: { schema } })`.
+     * Can also be passed here for standalone effectBridge usage.
      */
     schema?: Record<string, unknown>;
 }
@@ -53,11 +45,16 @@ export interface EffectBridgeConfig<E extends Env, CustomServices = never> {
  */
 declare const EFFECT_RUNTIME: unique symbol;
 /**
- * Extend Hono context with Effect runtime.
+ * Symbol for storing schema in Hono context.
+ */
+declare const EFFECT_SCHEMA: unique symbol;
+/**
+ * Extend Hono context with Effect runtime and schema.
  */
 declare module 'hono' {
     interface ContextVariableMap {
         [EFFECT_RUNTIME]?: ManagedRuntime.ManagedRuntime<DatabaseService | AuthService | AuthUserService | HonertiaService | RequestService | ResponseFactoryService, never>;
+        [EFFECT_SCHEMA]?: Record<string, unknown>;
     }
 }
 /**
@@ -72,5 +69,9 @@ export declare function getEffectRuntime<E extends Env>(c: HonoContext<E>): Mana
  * Middleware that sets up the Effect runtime for each request.
  */
 export declare function effectBridge<E extends Env, CustomServices = never>(config?: EffectBridgeConfig<E, CustomServices>): MiddlewareHandler<E>;
+/**
+ * Get the schema from Hono context (set by effectBridge).
+ */
+export declare function getEffectSchema<E extends Env>(c: HonoContext<E>): Record<string, unknown> | undefined;
 export {};
 //# sourceMappingURL=bridge.d.ts.map

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,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAA;AAC9C,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,EAOvB,MAAM,eAAe,CAAA;AAEtB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,GAAG,EAAE,cAAc,GAAG,KAAK;IACvE,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,OAAO,CAAA;IACzC;;;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;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AAED;;GAEG;AACH,QAAA,MAAM,cAAc,eAA0B,CAAA;AAE9C;;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;KACF;CACF;AAqDD;;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,cAAc,EAChB,KAAK,EACL,KAAK,CACN,CA0CA;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,CAetB"}
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/effect/bridge.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAA;AAC9C,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,EAOvB,MAAM,eAAe,CAAA;AAEtB;;;;;;;;;;;;;;;;;;;;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;AA6B5C;;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;AAqDD;;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,cAAc,EAChB,KAAK,EACL,KAAK,CACN,CA0DA;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,CAoBtB;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

@@ -9,6 +9,28 @@ import { DatabaseService, AuthService, AuthUserService, HonertiaService, Request
  * Symbol for storing Effect runtime in Hono context.
  */
 const EFFECT_RUNTIME = Symbol('effectRuntime');
+/**
+ * Symbol for storing schema in Hono context.
+ */
+const EFFECT_SCHEMA = Symbol('effectSchema');
+/**
+ * Creates a proxy that throws a helpful error when any property is accessed.
+ * Used when a service (database, auth) is not configured but the user tries to use it.
+ */
+function createUnconfiguredServiceProxy(serviceName, configPath, example) {
+    const message = `${serviceName} is not configured. Add it to setupHonertia: setupHonertia({ honertia: { ${configPath} } })`;
+    return new Proxy({}, {
+        get(_, prop) {
+            // Allow certain properties that might be checked without meaning to "use" the service
+            if (prop === 'then' || prop === Symbol.toStringTag || prop === Symbol.iterator) {
+                return undefined;
+            }
+            const error = new Error(message);
+            error.hint = `Example: ${example}`;
+            throw error;
+        },
+    });
+}
 /**
  * Create a RequestContext from Hono context.
  */
@@ -64,14 +86,15 @@ export function buildContextLayer(c, config) {
     const requestLayer = Layer.succeed(RequestService, createRequestContext(c));
     const responseLayer = Layer.succeed(ResponseFactoryService, createResponseFactory(c));
     const honertiaLayer = Layer.succeed(HonertiaService, createHonertiaRenderer(c));
-    // Build optional layers (cast to satisfy type checker - actual type comes from augmentation)
-    const databaseLayer = config?.database
-        ? Layer.succeed(DatabaseService, config.database(c))
-        : Layer.succeed(DatabaseService, c.var?.db);
-    let baseLayer = Layer.mergeAll(requestLayer, responseLayer, honertiaLayer, databaseLayer);
-    if (c.var?.auth) {
-        baseLayer = Layer.merge(baseLayer, Layer.succeed(AuthService, c.var.auth));
-    }
+    // Database layer - provide helpful error proxy if not configured
+    const db = c.var?.db;
+    const databaseLayer = Layer.succeed(DatabaseService, (db ??
+        createUnconfiguredServiceProxy('DatabaseService', 'database: (c) => createDb(...)', 'database: (c) => drizzle(c.env.DB)')));
+    // Auth layer - provide helpful error proxy if not configured
+    const auth = c.var?.auth;
+    const authLayer = Layer.succeed(AuthService, (auth ??
+        createUnconfiguredServiceProxy('AuthService', 'auth: (c) => createAuth(...)', 'auth: (c) => betterAuth({ database: c.var.db, ... })')));
+    let baseLayer = Layer.mergeAll(requestLayer, responseLayer, honertiaLayer, databaseLayer, authLayer);
     if (c.var?.authUser) {
         baseLayer = Layer.merge(baseLayer, Layer.succeed(AuthUserService, c.var.authUser));
     }
@@ -97,6 +120,10 @@ export function effectBridge(config) {
         const runtime = ManagedRuntime.make(layer);
         // Store runtime in context
         c.set(EFFECT_RUNTIME, runtime);
+        // Store schema in context for route model binding
+        if (config?.schema) {
+            c.set(EFFECT_SCHEMA, config.schema);
+        }
         try {
             await next();
         }
@@ -106,3 +133,9 @@ export function effectBridge(config) {
         }
     };
 }
+/**
+ * Get the schema from Hono context (set by effectBridge).
+ */
+export function getEffectSchema(c) {
+    return c.var?.[EFFECT_SCHEMA];
+}

package/dist/effect/handler.d.ts

@@ -8,6 +8,11 @@ import type { Context as HonoContext, MiddlewareHandler, Env } from 'hono';
 import { Redirect, type AppError } from './errors.js';
 /**
  * Convert an Effect error to an HTTP response.
+ *
+ * Most errors are re-thrown so Hono's onError handler can render them
+ * via Honertia's error component. Only errors that need special handling
+ * (ValidationError for form re-rendering, UnauthorizedError for redirects)
+ * return responses directly.
  */
 export declare function errorToResponse<E extends Env>(error: AppError, c: HonoContext<E>): Promise<Response>;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/effect/handler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAA+B,MAAM,QAAQ,CAAA;AAC5D,OAAO,KAAK,EAAE,OAAO,IAAI,WAAW,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAE1E,OAAO,EAOL,QAAQ,EACR,KAAK,QAAQ,EACd,MAAM,aAAa,CAAA;AAGpB;;GAEG;AACH,wBAAsB,eAAe,CAAC,CAAC,SAAS,GAAG,EACjD,KAAK,EAAE,QAAQ,EACf,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GAChB,OAAO,CAAC,QAAQ,CAAC,CAyDnB;AAgBD;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC,EAAE,GAAG,SAAS,QAAQ,EAClE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,GAAG,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,GACjD,iBAAiB,CAAC,CAAC,CAAC,CAoBtB;AAsCD;;GAEG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC,EAAE,GAAG,SAAS,QAAQ,EAC3D,EAAE,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,QAAQ,GAAG,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,GACnD,iBAAiB,CAAC,CAAC,CAAC,CAEtB;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,sBAAgB,CAAA"}
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/effect/handler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAA+B,MAAM,QAAQ,CAAA;AAC5D,OAAO,KAAK,EAAE,OAAO,IAAI,WAAW,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAE1E,OAAO,EAML,QAAQ,EACR,KAAK,QAAQ,EACd,MAAM,aAAa,CAAA;AAuBpB;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,CAAC,SAAS,GAAG,EACjD,KAAK,EAAE,QAAQ,EACf,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,GAChB,OAAO,CAAC,QAAQ,CAAC,CAiDnB;AAgBD;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC,EAAE,GAAG,SAAS,QAAQ,EAClE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,GAAG,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,GACjD,iBAAiB,CAAC,CAAC,CAAC,CAoBtB;AAgDD;;GAEG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC,EAAE,GAAG,SAAS,QAAQ,EAC3D,EAAE,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,QAAQ,GAAG,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,GACnD,iBAAiB,CAAC,CAAC,CAAC,CAEtB;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,sBAAgB,CAAA"}

package/dist/effect/handler.js

@@ -5,11 +5,36 @@
  */
 import { Effect, Exit, Cause, ManagedRuntime } from 'effect';
 import { getEffectRuntime, buildContextLayer } from './bridge.js';
-import { ValidationError, UnauthorizedError, NotFoundError, ForbiddenError, HttpError, RouteConfigurationError, Redirect, } from './errors.js';
+import { ValidationError, UnauthorizedError, NotFoundError, HttpError, RouteConfigurationError, Redirect, } from './errors.js';
+/**
+ * Convert an AppError to a throwable Error for Hono's onError handler.
+ * Preserves error metadata like status codes and hints.
+ */
+function toThrowableError(error) {
+    const err = new Error(error.message);
+    err.name = error._tag;
+    // Preserve status for HttpError
+    if (error instanceof HttpError) {
+        ;
+        err.status = error.status;
+    }
+    // Preserve hint for RouteConfigurationError
+    if (error instanceof RouteConfigurationError && error.hint) {
+        ;
+        err.hint = error.hint;
+    }
+    return err;
+}
 /**
  * Convert an Effect error to an HTTP response.
+ *
+ * Most errors are re-thrown so Hono's onError handler can render them
+ * via Honertia's error component. Only errors that need special handling
+ * (ValidationError for form re-rendering, UnauthorizedError for redirects)
+ * return responses directly.
  */
 export async function errorToResponse(error, c) {
+    // ValidationError: re-render form with errors or redirect back
     if (error instanceof ValidationError) {
         const isInertia = c.req.header('X-Inertia') === 'true';
         const prefersJson = c.req.header('Accept')?.includes('application/json') ||
@@ -28,34 +53,26 @@ export async function errorToResponse(error, c) {
         c.var?.honertia?.setErrors(error.errors);
         return c.redirect(referer, 303);
     }
+    // UnauthorizedError: redirect to login
     if (error instanceof UnauthorizedError) {
         const isInertia = c.req.header('X-Inertia') === 'true';
         const redirectTo = error.redirectTo ?? '/login';
         return c.redirect(redirectTo, isInertia ? 303 : 302);
     }
-    if (error instanceof ForbiddenError) {
-        return c.json({ message: error.message }, 403);
-    }
+    // NotFoundError: use Hono's notFound handler (renders via Honertia if configured)
     if (error instanceof NotFoundError) {
         return c.notFound();
     }
+    // ForbiddenError: return 403 JSON (useful for API routes)
+    if ('_tag' in error && error._tag === 'ForbiddenError') {
+        return c.json({ message: error.message }, 403);
+    }
+    // HttpError: return custom status JSON (gives developers control over HTTP responses)
     if (error instanceof HttpError) {
         return c.json({ message: error.message, ...error.body }, error.status);
     }
-    if (error instanceof RouteConfigurationError) {
-        console.error(`[honertia] Route configuration error: ${error.message}`);
-        if (error.hint) {
-            console.error(`[honertia] Hint: ${error.hint}`);
-        }
-        return c.json({
-            message: error.message,
-            hint: error.hint,
-            type: 'RouteConfigurationError'
-        }, 500);
-    }
-    // Unknown error
-    console.error('Unhandled error:', error);
-    return c.json({ message: 'Internal server error' }, 500);
+    // All other errors (RouteConfigurationError, etc.): throw to Hono's onError handler
+    throw toThrowableError(error);
 }
 /**
  * Handle a Redirect value (which is not an error).
@@ -93,6 +110,9 @@ export function effectHandler(effect) {
 }
 /**
  * Handle an Effect exit value.
+ *
+ * Failures are converted to responses via errorToResponse.
+ * Defects (unexpected errors) are re-thrown for Hono's onError handler.
  */
 async function handleExit(exit, c) {
     if (Exit.isSuccess(exit)) {
@@ -102,7 +122,7 @@ async function handleExit(exit, c) {
         }
         return value;
     }
-    // Handle failure
+    // Handle typed failures
     const cause = exit.cause;
     if (Cause.isFailure(cause)) {
         const error = Cause.failureOption(cause);
@@ -110,14 +130,21 @@ async function handleExit(exit, c) {
             return await errorToResponse(error.value, c);
         }
     }
-    // Handle defects (unexpected errors)
+    // Handle defects (unexpected errors) - throw to Hono's onError handler
     if (Cause.isDie(cause)) {
         const defect = Cause.dieOption(cause);
         if (defect._tag === 'Some') {
-            console.error('Effect defect:', defect.value);
+            const err = defect.value;
+            // If it's already an Error, throw it directly
+            if (err instanceof Error) {
+                throw err;
+            }
+            // Otherwise wrap it
+            throw new Error(String(err));
         }
     }
-    return c.json({ message: 'Internal server error' }, 500);
+    // Fallback: throw generic error for Hono's onError handler
+    throw new Error('Unknown effect failure');
 }
 /**
  * Create a handler from a function that returns an Effect.

package/dist/effect/index.d.ts

@@ -7,7 +7,7 @@ export { DatabaseService, AuthService, AuthUserService, HonertiaService, Request
 export { ValidationError, UnauthorizedError, NotFoundError, ForbiddenError, HttpError, RouteConfigurationError, Redirect, type AppError, } from './errors.js';
 export * from './schema.js';
 export { getValidationData, formatSchemaErrors, validate, validateRequest, asValidated, asTrusted, type Validated, type Trusted, } from './validation.js';
-export { effectBridge, buildContextLayer, getEffectRuntime, type EffectBridgeConfig, } from './bridge.js';
+export { effectBridge, buildContextLayer, getEffectRuntime, getEffectSchema, type EffectBridgeConfig, } from './bridge.js';
 export { effectHandler, effect, handle, errorToResponse, } from './handler.js';
 export { action, authorize, dbMutation, dbTransaction, type SafeTx, } from './action.js';
 export { redirect, render, renderWithErrors, json, text, notFound, forbidden, httpError, prefersJson, jsonOrRender, share, } from './responses.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/effect/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,eAAe,EACf,WAAW,EACX,eAAe,EACf,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,QAAQ,GACd,MAAM,eAAe,CAAA;AAGtB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,SAAS,EACT,uBAAuB,EACvB,QAAQ,EACR,KAAK,QAAQ,GACd,MAAM,aAAa,CAAA;AAGpB,cAAc,aAAa,CAAA;AAG3B,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,QAAQ,EACR,eAAe,EACf,WAAW,EACX,SAAS,EACT,KAAK,SAAS,EACd,KAAK,OAAO,GACb,MAAM,iBAAiB,CAAA;AAGxB,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAA;AAGpB,OAAO,EACL,aAAa,EACb,MAAM,EACN,MAAM,EACN,eAAe,GAChB,MAAM,cAAc,CAAA;AAGrB,OAAO,EACL,MAAM,EACN,SAAS,EACT,UAAU,EACV,aAAa,EACb,KAAK,MAAM,GACZ,MAAM,aAAa,CAAA;AAGpB,OAAO,EACL,QAAQ,EACR,MAAM,EACN,gBAAgB,EAChB,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,SAAS,EACT,WAAW,EACX,YAAY,EACZ,KAAK,GACN,MAAM,gBAAgB,CAAA;AAGvB,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,kBAAkB,GACxB,MAAM,cAAc,CAAA;AAGrB,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,KAAK,EACL,SAAS,EACT,aAAa,EACb,UAAU,EACV,KAAK,aAAa,EAClB,KAAK,UAAU,GAChB,MAAM,cAAc,CAAA;AAGrB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,WAAW,EACX,YAAY,EACZ,SAAS,EACT,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,QAAQ,EACR,KAAK,gBAAgB,EACrB,KAAK,0BAA0B,EAC/B,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,GAC5B,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/effect/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,eAAe,EACf,WAAW,EACX,eAAe,EACf,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,KAAK,QAAQ,EACb,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,QAAQ,GACd,MAAM,eAAe,CAAA;AAGtB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,SAAS,EACT,uBAAuB,EACvB,QAAQ,EACR,KAAK,QAAQ,GACd,MAAM,aAAa,CAAA;AAGpB,cAAc,aAAa,CAAA;AAG3B,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,QAAQ,EACR,eAAe,EACf,WAAW,EACX,SAAS,EACT,KAAK,SAAS,EACd,KAAK,OAAO,GACb,MAAM,iBAAiB,CAAA;AAGxB,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAA;AAGpB,OAAO,EACL,aAAa,EACb,MAAM,EACN,MAAM,EACN,eAAe,GAChB,MAAM,cAAc,CAAA;AAGrB,OAAO,EACL,MAAM,EACN,SAAS,EACT,UAAU,EACV,aAAa,EACb,KAAK,MAAM,GACZ,MAAM,aAAa,CAAA;AAGpB,OAAO,EACL,QAAQ,EACR,MAAM,EACN,gBAAgB,EAChB,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,SAAS,EACT,WAAW,EACX,YAAY,EACZ,KAAK,GACN,MAAM,gBAAgB,CAAA;AAGvB,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,kBAAkB,GACxB,MAAM,cAAc,CAAA;AAGrB,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,KAAK,EACL,SAAS,EACT,aAAa,EACb,UAAU,EACV,KAAK,aAAa,EAClB,KAAK,UAAU,GAChB,MAAM,cAAc,CAAA;AAGrB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,WAAW,EACX,YAAY,EACZ,SAAS,EACT,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,QAAQ,EACR,KAAK,gBAAgB,EACrB,KAAK,0BAA0B,EAC/B,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,GAC5B,MAAM,WAAW,CAAA"}

package/dist/effect/index.js

@@ -12,7 +12,7 @@ export * from './schema.js';
 // Validation Helpers
 export { getValidationData, formatSchemaErrors, validate, validateRequest, asValidated, asTrusted, } from './validation.js';
 // Bridge
-export { effectBridge, buildContextLayer, getEffectRuntime, } from './bridge.js';
+export { effectBridge, buildContextLayer, getEffectRuntime, getEffectSchema, } from './bridge.js';
 // Handler
 export { effectHandler, effect, handle, errorToResponse, } from './handler.js';
 // Action Composables

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

@@ -1 +1 @@
-{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../src/effect/routing.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../src/effect/routing.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAQ,KAAK,EAAE,MAAM,IAAI,CAAC,EAAE,MAAM,QAAQ,CAAA;AACzD,OAAO,KAAK,EAA0B,IAAI,EAAqB,GAAG,EAAE,MAAM,MAAM,CAAA;AAEhF,OAAO,EAAsC,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACzF,OAAO,EACL,KAAK,QAAQ,EACb,QAAQ,EACT,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,eAAe,EACf,WAAW,EACX,eAAe,EACf,cAAc,EACd,sBAAsB,EACvB,MAAM,eAAe,CAAA;AACtB,OAAO,EAKL,WAAW,EAEZ,MAAM,cAAc,CAAA;AAErB;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,SAAS,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,CACjG,QAAQ,GAAG,QAAQ,EACnB,CAAC,EACD,CAAC,CACF,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,cAAc,GACd,sBAAsB,GACtB,eAAe,GACf,eAAe,GACf,WAAW,GACX,WAAW,CAAA;AAEf;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAA;CACtB;AAED;;GAEG;AACH,qBAAa,kBAAkB,CAC7B,CAAC,SAAS,GAAG,EACb,gBAAgB,GAAG,KAAK,EACxB,cAAc,GAAG,KAAK;IAGpB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;gBAHb,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,EACZ,MAAM,GAAE,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,EAAO,EAC7C,UAAU,GAAE,MAAW,EACvB,YAAY,CAAC,EAAE,kBAAkB,CAAC,CAAC,EAAE,cAAc,CAAC,YAAA;IAGvE;;;OAGG;IACH,OAAO,CAAC,CAAC,EAAE,QAAQ,SAAS,QAAQ,EAClC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,GACrC,kBAAkB,CAAC,CAAC,EAAE,gBAAgB,GAAG,CAAC,EAAE,cAAc,CAAC;IAS9D;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAAC,CAAC,EAAE,gBAAgB,EAAE,cAAc,CAAC;IAU7E;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC,EAAE,gBAAgB,EAAE,cAAc,CAAC,KAAK,IAAI,GAAG,IAAI;IAI/F;;OAEG;IACH,OAAO,CAAC,WAAW;IAOnB;;OAEG;YACW,YAAY;IAoB1B;;;OAGG;YACW,eAAe;IAgE7B,OAAO,CAAC,aAAa;IAyDrB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAWrB,4FAA4F;IAC5F,GAAG,CAAC,CAAC,SAAS,YAAY,GAAG,gBAAgB,GAAG,cAAc,EAC5D,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,aAAa,CAAC,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC,EAC1C,OAAO,CAAC,EAAE,kBAAkB,GAC3B,IAAI;IAIP,6FAA6F;IAC7F,IAAI,CAAC,CAAC,SAAS,YAAY,GAAG,gBAAgB,GAAG,cAAc,EAC7D,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,aAAa,CAAC,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC,EAC1C,OAAO,CAAC,EAAE,kBAAkB,GAC3B,IAAI;IAIP,4FAA4F;IAC5F,GAAG,CAAC,CAAC,SAAS,YAAY,GAAG,gBAAgB,GAAG,cAAc,EAC5D,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,aAAa,CAAC,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC,EAC1C,OAAO,CAAC,EAAE,kBAAkB,GAC3B,IAAI;IAIP,8FAA8F;IAC9F,KAAK,CAAC,CAAC,SAAS,YAAY,GAAG,gBAAgB,GAAG,cAAc,EAC9D,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,aAAa,CAAC,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC,EAC1C,OAAO,CAAC,EAAE,kBAAkB,GAC3B,IAAI;IAIP,+FAA+F;IAC/F,MAAM,CAAC,CAAC,SAAS,YAAY,GAAG,gBAAgB,GAAG,cAAc,EAC/D,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,aAAa,CAAC,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC,EAC1C,OAAO,CAAC,EAAE,kBAAkB,GAC3B,IAAI;IAIP,6GAA6G;IAC7G,GAAG,CAAC,CAAC,SAAS,YAAY,GAAG,gBAAgB,GAAG,cAAc,EAC5D,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,aAAa,CAAC,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC,EAC1C,OAAO,CAAC,EAAE,kBAAkB,GAC3B,IAAI;CAGR;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,GAAG,EAAE,cAAc,GAAG,KAAK,EAChE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,EACZ,MAAM,CAAC,EAAE,kBAAkB,CAAC,CAAC,EAAE,cAAc,CAAC,GAC7C,kBAAkB,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,CAE9C"}

package/dist/effect/routing.js

@@ -5,7 +5,7 @@
  */
 import { Effect, Exit, Layer, Schema as S } from 'effect';
 import { effectHandler } from './handler.js';
-import { buildContextLayer } from './bridge.js';
+import { buildContextLayer, getEffectSchema } from './bridge.js';
 import { parseBindings, toHonoPath, pluralize, findRelation, BoundModels, } from './binding.js';
 /**
  * Effect Route Builder with layer composition.
@@ -125,18 +125,20 @@ export class EffectRouteBuilder {
             const contextLayer = buildContextLayer(c, bridgeConfig);
             // Resolve route model bindings if we have any and schema is configured
             let boundModelsLayer;
-            if (bindings.length > 0 && bridgeConfig?.schema) {
-                const db = bridgeConfig.database ? bridgeConfig.database(c) : c.var?.db;
+            // Get schema from bridgeConfig or from context (set by setupHonertia/effectBridge)
+            const schema = bridgeConfig?.schema ?? getEffectSchema(c);
+            if (bindings.length > 0 && schema) {
+                const db = c.var?.db;
                 if (!db) {
                     return c.notFound();
                 }
-                const result = await this.resolveBindings(c, bindings, db, bridgeConfig.schema);
+                const result = await this.resolveBindings(c, bindings, db, schema);
                 if (result instanceof Response) {
                     return result;
                 }
                 boundModelsLayer = Layer.succeed(BoundModels, result);
             }
-            else if (bindings.length > 0 && !bridgeConfig?.schema) {
+            else if (bindings.length > 0 && !schema) {
                 // Bindings exist but no schema - provide a map that signals this for better errors
                 const unconfiguredMap = new Map();
                 unconfiguredMap.set('__schema_not_configured__', true);

package/dist/index.d.ts

@@ -6,7 +6,7 @@
  * For schema validators, import from 'honertia/schema'.
  * For auth helpers, import from 'honertia/auth'.
  */
-export { setupHonertia, createErrorHandlers, registerErrorHandlers, type HonertiaSetupConfig, type ErrorHandlerConfig, } from './setup.js';
+export { setupHonertia, createErrorHandlers, registerErrorHandlers, type HonertiaSetupConfig, type HonertiaFullConfig, type ErrorHandlerConfig, } from './setup.js';
 export { honertia, HEADERS } from './middleware.js';
 export type { PageObject, HonertiaConfig, HonertiaInstance, RenderOptions, } from './types.js';
 export { createTemplate, createVersion, vite, type PageProps, } from './helpers.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAEnD,YAAY,EACV,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,aAAa,GACd,MAAM,YAAY,CAAA;AAGnB,OAAO,EACL,cAAc,EACd,aAAa,EACb,IAAI,EACJ,KAAK,SAAS,GACf,MAAM,cAAc,CAAA;AAOrB,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAEnD,YAAY,EACV,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,aAAa,GACd,MAAM,YAAY,CAAA;AAGnB,OAAO,EACL,cAAc,EACd,aAAa,EACb,IAAI,EACJ,KAAK,SAAS,GACf,MAAM,cAAc,CAAA;AAOrB,cAAc,mBAAmB,CAAA"}

package/dist/setup.d.ts

@@ -7,20 +7,66 @@
 import type { MiddlewareHandler, Env, Context } from 'hono';
 import type { HonertiaConfig } from './types.js';
 import { type EffectBridgeConfig } from './effect/bridge.js';
+/**
+ * Extended Honertia configuration with database, auth, and schema.
+ */
+export interface HonertiaFullConfig<E extends Env = Env> extends HonertiaConfig {
+    /**
+     * Database factory function.
+     * Creates the database client for each request.
+     *
+     * @example
+     * ```typescript
+     * database: (c) => createDb(c.env.DATABASE_URL)
+     * ```
+     */
+    database?: (c: Context<E>) => unknown;
+    /**
+     * Auth factory function.
+     * Creates the auth client for each request.
+     * Receives context with `c.var.db` already set (if database is configured).
+     *
+     * @example
+     * ```typescript
+     * auth: (c) => createAuth({
+     *   db: c.var.db,
+     *   secret: c.env.BETTER_AUTH_SECRET,
+     *   baseURL: new URL(c.req.url).origin,
+     * })
+     * ```
+     */
+    auth?: (c: Context<E>) => unknown;
+    /**
+     * Drizzle schema for route model binding.
+     * Required if using Laravel-style route model binding.
+     *
+     * @example
+     * ```typescript
+     * import * as schema from '~/db/schema'
+     *
+     * setupHonertia({
+     *   honertia: { version, render, schema }
+     * })
+     * ```
+     */
+    schema?: Record<string, unknown>;
+}
 /**
  * Configuration for Honertia setup.
  */
 export interface HonertiaSetupConfig<E extends Env = Env, CustomServices = never> {
     /**
-     * Honertia core configuration.
+     * Honertia core configuration including database, auth, and schema.
      */
-    honertia: HonertiaConfig;
+    honertia: HonertiaFullConfig<E>;
     /**
      * Effect bridge configuration (optional).
+     * Only needed for custom Effect services.
      */
     effect?: EffectBridgeConfig<E, CustomServices>;
     /**
-     * Auth configuration (optional).
+     * Auth loading configuration (optional).
+     * Controls how the authenticated user is loaded from the session.
      */
     auth?: {
         userKey?: string;
@@ -36,6 +82,7 @@ export interface HonertiaSetupConfig<E extends Env = Env, CustomServices = never
  * Sets up all Honertia middleware in the correct order.
  *
  * This bundles:
+ * - Database and auth setup (sets `c.var.db` and `c.var.auth`)
  * - `honertia()` - Core Honertia middleware
  * - `loadUser()` - Loads authenticated user into context
  * - `shareAuthMiddleware()` - Shares auth state with pages
@@ -44,11 +91,19 @@ export interface HonertiaSetupConfig<E extends Env = Env, CustomServices = never
  * @example
  * ```ts
  * import { setupHonertia, createTemplate } from 'honertia'
+ * import * as schema from '~/db/schema'
  *
  * app.use('*', setupHonertia({
  *   honertia: {
  *     version: '1.0.0',
  *     render: createTemplate({ title: 'My App', scripts: [...] }),
+ *     database: (c) => createDb(c.env.DATABASE_URL),
+ *     auth: (c) => createAuth({
+ *       db: c.var.db,
+ *       secret: c.env.BETTER_AUTH_SECRET,
+ *       baseURL: new URL(c.req.url).origin,
+ *     }),
+ *     schema,
  *   },
  * }))
  * ```

package/dist/setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAE3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD,OAAO,EAAgB,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAE1E;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,EAAE,cAAc,GAAG,KAAK;IAC9E;;OAEG;IACH,QAAQ,EAAE,cAAc,CAAA;IAExB;;OAEG;IACH,MAAM,CAAC,EAAE,kBAAkB,CAAC,CAAC,EAAE,cAAc,CAAC,CAAA;IAE9C;;OAEG;IACH,IAAI,CAAC,EAAE;QACL,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,aAAa,CAAC,EAAE,MAAM,CAAA;KACvB,CAAA;IAED;;;OAGG;IACH,UAAU,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAA;CACpC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,GAAG,EAAE,cAAc,GAAG,KAAK,EACjE,MAAM,EAAE,mBAAmB,CAAC,CAAC,EAAE,cAAc,CAAC,GAC7C,iBAAiB,CAAC,CAAC,CAAC,CAmBtB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IAEvB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,GAAG,EAAE,MAAM,GAAE,kBAAuB;kBAQ3D,OAAO,CAAC,CAAC,CAAC;mBAOT,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC;EAU3C;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,GAAG,EACjD,GAAG,EAAE;IAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,CAAC;IAAC,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,CAAA;CAAE,EAC1E,MAAM,GAAE,kBAAuB,GAC9B,IAAI,CAIN"}
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAE3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD,OAAO,EAAgB,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAE1E;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,CAAE,SAAQ,cAAc;IAC7E;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAA;IAErC;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAA;IAEjC;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,EAAE,cAAc,GAAG,KAAK;IAC9E;;OAEG;IACH,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAA;IAE/B;;;OAGG;IACH,MAAM,CAAC,EAAE,kBAAkB,CAAC,CAAC,EAAE,cAAc,CAAC,CAAA;IAE9C;;;OAGG;IACH,IAAI,CAAC,EAAE;QACL,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,aAAa,CAAC,EAAE,MAAM,CAAA;KACvB,CAAA;IAED;;;OAGG;IACH,UAAU,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAA;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,GAAG,EAAE,cAAc,GAAG,KAAK,EACjE,MAAM,EAAE,mBAAmB,CAAC,CAAC,EAAE,cAAc,CAAC,GAC7C,iBAAiB,CAAC,CAAC,CAAC,CA2CtB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IAEvB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,GAAG,EAAE,MAAM,GAAE,kBAAuB;kBAQ3D,OAAO,CAAC,CAAC,CAAC;mBAOT,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC;EAa3C;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,GAAG,EACjD,GAAG,EAAE;IAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,CAAC;IAAC,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,CAAA;CAAE,EAC1E,MAAM,GAAE,kBAAuB,GAC9B,IAAI,CAIN"}

package/dist/setup.js

@@ -12,6 +12,7 @@ import { effectBridge } from './effect/bridge.js';
  * Sets up all Honertia middleware in the correct order.
  *
  * This bundles:
+ * - Database and auth setup (sets `c.var.db` and `c.var.auth`)
  * - `honertia()` - Core Honertia middleware
  * - `loadUser()` - Loads authenticated user into context
  * - `shareAuthMiddleware()` - Shares auth state with pages
@@ -20,21 +21,48 @@ import { effectBridge } from './effect/bridge.js';
  * @example
  * ```ts
  * import { setupHonertia, createTemplate } from 'honertia'
+ * import * as schema from '~/db/schema'
  *
  * app.use('*', setupHonertia({
  *   honertia: {
  *     version: '1.0.0',
  *     render: createTemplate({ title: 'My App', scripts: [...] }),
+ *     database: (c) => createDb(c.env.DATABASE_URL),
+ *     auth: (c) => createAuth({
+ *       db: c.var.db,
+ *       secret: c.env.BETTER_AUTH_SECRET,
+ *       baseURL: new URL(c.req.url).origin,
+ *     }),
+ *     schema,
  *   },
  * }))
  * ```
  */
 export function setupHonertia(config) {
+    const { database, auth, schema, ...honertiaConfig } = config.honertia;
+    // Middleware to set up db and auth on c.var
+    const setupServices = createMiddleware(async (c, next) => {
+        // Set up database first (auth may depend on it)
+        if (database) {
+            c.set('db', database(c));
+        }
+        // Set up auth (can access c.var.db)
+        if (auth) {
+            c.set('auth', auth(c));
+        }
+        await next();
+    });
+    // Build effect bridge config, passing schema from honertia config
+    const effectConfig = {
+        ...config.effect,
+        schema,
+    };
     const middlewares = [
-        honertia(config.honertia),
+        setupServices,
+        honertia(honertiaConfig),
         loadUser(config.auth),
         shareAuthMiddleware(),
-        effectBridge(config.effect),
+        effectBridge(effectConfig),
         ...(config.middleware ?? []),
     ];
     return createMiddleware(async (c, next) => {
@@ -72,9 +100,12 @@ export function createErrorHandlers(config = {}) {
     const onError = (err, c) => {
         console.error(err);
         const isDev = showDevErrors && c.env?.[envKey] === devValue;
+        const status = err.status ?? 500;
+        const hint = isDev ? err.hint : undefined;
         return c.var.honertia.render(component, {
-            status: 500,
+            status,
             message: isDev ? err.message : 'Something went wrong',
+            ...(hint && { hint }),
         });
     };
     return { notFound, onError };

package/package.json

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