honertia 0.1.11 → 0.1.13

package/README.md

@@ -907,6 +907,174 @@ effectRoutes(app).group((route) => {
 })
 ```
 
+#### Route Parameter Validation
+
+You can pass a `params` schema to validate route parameters before your handler runs. Invalid values automatically return a 404:
+
+```typescript
+import { Schema as S } from 'effect'
+import { uuid } from 'honertia/effect'
+
+effectRoutes(app).get(
+  '/projects/:id',
+  showProject,
+  { params: S.Struct({ id: uuid }) }
+)
+```
+
+This runs validation *before* the handler executes, so invalid UUIDs never hit your database. You can validate multiple params and use any Effect Schema:
+
+```typescript
+effectRoutes(app).get(
+  '/api/:version/projects/:id',
+  showProject,
+  {
+    params: S.Struct({
+      version: S.Literal('v1', 'v2'),
+      id: uuid,
+    }),
+  }
+)
+```
+
+#### Laravel-Style Route Model Binding
+
+Honertia supports Laravel-style route model binding with the `{param}` syntax. This automatically resolves route parameters to database models, returning 404 if the model isn't found.
+
+**Setup:**
+
+1. Add your Drizzle schema to the module augmentation:
+
+```typescript
+// src/types.d.ts
+import type { Database } from '~/db/db'
+import type { auth } from '~/lib/auth'
+import * as schema from '~/db/schema'
+
+declare module 'honertia/effect' {
+  interface HonertiaDatabaseType {
+    type: Database
+    schema: typeof schema  // Add this for route model binding
+  }
+
+  interface HonertiaAuthType {
+    type: typeof auth
+  }
+}
+```
+
+2. Pass your schema to `effectRoutes`:
+
+```typescript
+import * as schema from '~/db/schema'
+
+effectRoutes(app, { schema })
+  .get('/projects/{project}', showProject)
+```
+
+**Basic Usage:**
+
+```typescript
+import { bound } from 'honertia/effect'
+
+// Route: /projects/{project}
+// Automatically queries: SELECT * FROM projects WHERE id = :project
+
+effectRoutes(app, { schema }).get('/projects/{project}', showProject)
+
+const showProject = Effect.gen(function* () {
+  const project = yield* bound('project')  // Already fetched, guaranteed to exist
+  return yield* render('Projects/Show', { project })
+})
+```
+
+**Custom Column Binding:**
+
+By default, bindings query the `id` column. Use `{param:column}` syntax to bind by a different column:
+
+```typescript
+// Bind by slug instead of id
+effectRoutes(app, { schema }).get('/projects/{project:slug}', showProject)
+// Queries: SELECT * FROM projects WHERE slug = :project
+```
+
+**Nested Route Scoping:**
+
+For nested routes, Honertia automatically scopes child models to their parents using Drizzle relations:
+
+```typescript
+// Route: /users/{user}/posts/{post}
+effectRoutes(app, { schema }).get('/users/{user}/posts/{post}', showUserPost)
+
+// Queries:
+// 1. SELECT * FROM users WHERE id = :user
+// 2. SELECT * FROM posts WHERE id = :post AND userId = :user.id
+```
+
+This uses your Drizzle relations to discover the foreign key:
+
+```typescript
+// db/schema.ts
+export const postsRelations = relations(posts, ({ one }) => ({
+  user: one(users, {
+    fields: [posts.userId],
+    references: [users.id],
+  }),
+}))
+```
+
+If no relation is found, the child is resolved without scoping (useful for unrelated resources in the same route).
+
+**How Binding Works:**
+
+1. `{project}` is converted to `:project` for Hono's router
+2. At request time, the param value is extracted
+3. The table name is derived by pluralizing the param (`project` → `projects`)
+4. A database query is executed against that table
+5. If not found, a 404 is returned before your handler runs
+6. If found, the model is available via `bound('project')`
+
+**Combining with Param Validation:**
+
+Route model binding and param validation work together. Validation runs first:
+
+```typescript
+effectRoutes(app, { schema }).get(
+  '/projects/{project}',
+  showProject,
+  { params: S.Struct({ project: uuid }) }  // Validates UUID format first
+)
+```
+
+Order of execution:
+1. Param validation (returns 404 if schema fails)
+2. Model binding (returns 404 if not found in database)
+3. Your handler (model guaranteed to exist)
+
+**Mixed Notation:**
+
+You can mix Laravel-style `{binding}` with Hono-style `:param` in the same route. Only `{binding}` params are resolved from the database:
+
+```typescript
+// :version is a regular Hono param (not bound)
+// {project} is resolved from the database
+effectRoutes(app, { schema }).get(
+  '/api/:version/projects/{project}',
+  showProject
+)
+
+const showProject = Effect.gen(function* () {
+  const request = yield* RequestService
+  const version = request.param('version')  // 'v1', 'v2', etc.
+  const project = yield* bound('project')   // Database model
+  // ...
+})
+```
+
+**Performance:**
+
+Routes without `{bindings}` have zero overhead—binding resolution only runs when Laravel-style params are detected. The binding check is a simple regex test at route registration time.
+
 ## Validation
 
 Honertia uses Effect Schema with Laravel-inspired validators:
@@ -1354,10 +1522,12 @@ By default, `DatabaseService` and `AuthService` are typed as `unknown` since Hon
 // src/types.d.ts (or any .d.ts file in your project)
 import type { Database } from '~/db/db'
 import type { auth } from '~/lib/auth'
+import * as schema from '~/db/schema'
 
 declare module 'honertia/effect' {
   interface HonertiaDatabaseType {
-    type: Database // Your Drizzle/Prisma/Kysely type
+    type: Database        // Your Drizzle/Prisma/Kysely type
+    schema: typeof schema // Your Drizzle schema (for route model binding)
   }
 
   interface HonertiaAuthType {

package/dist/effect/binding.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Route Model Binding
+ *
+ * Laravel-style route model binding for Effect routes.
+ * Automatically resolves route parameters to database models.
+ */
+import { Context, Effect } from 'effect';
+import type { Table } from 'drizzle-orm';
+import type { HonertiaDatabaseType } from './services.js';
+declare const BoundModelNotFound_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "BoundModelNotFound";
+} & Readonly<A>;
+/**
+ * Error thrown when a bound model is not found in the BoundModels context.
+ * This indicates a programming error - the binding key doesn't match any resolved model.
+ */
+export declare class BoundModelNotFound extends BoundModelNotFound_base<{
+    readonly key: string;
+}> {
+    get message(): string;
+}
+/**
+ * Parsed binding from route path.
+ */
+export interface ParsedBinding {
+    /** The parameter name (e.g., 'project' from '{project}') */
+    param: string;
+    /** The column to query (e.g., 'id' or 'slug' from '{project:slug}') */
+    column: string;
+}
+/**
+ * Parse Laravel-style bindings from a route path.
+ *
+ * @example
+ * parseBindings('/users/{user}/posts/{post:slug}')
+ * // => [{ param: 'user', column: 'id' }, { param: 'post', column: 'slug' }]
+ */
+export declare function parseBindings(path: string): ParsedBinding[];
+/**
+ * Convert Laravel-style route to Hono-style route.
+ *
+ * @example
+ * toHonoPath('/users/{user}/posts/{post:slug}')
+ * // => '/users/:user/posts/:post'
+ */
+export declare function toHonoPath(path: string): string;
+declare const BoundModels_base: Context.TagClass<BoundModels, "honertia/BoundModels", ReadonlyMap<string, unknown>>;
+/**
+ * Service tag for bound models.
+ * Provides access to resolved route models in handlers.
+ */
+export declare class BoundModels extends BoundModels_base {
+}
+/**
+ * Type-safe accessor for bound models.
+ *
+ * @example
+ * const showProject = Effect.gen(function* () {
+ *   const project = yield* bound('project')
+ *   return inertia('Projects/Show', { project })
+ * })
+ */
+export declare const bound: <K extends string>(key: K) => Effect.Effect<K extends keyof HonertiaDatabaseType["schema"] ? HonertiaDatabaseType["schema"][K] extends Table ? HonertiaDatabaseType["schema"][K]["$inferSelect"] : unknown : unknown, BoundModelNotFound, BoundModels>;
+/**
+ * Pluralize a singular word.
+ * Handles common English pluralization rules.
+ *
+ * @example
+ * pluralize('user')     // 'users'
+ * pluralize('category') // 'categories'
+ * pluralize('box')      // 'boxes'
+ * pluralize('class')    // 'classes'
+ */
+export declare function pluralize(word: string): string;
+/**
+ * Information about a relation between tables.
+ */
+export interface RelationInfo {
+    /** Foreign key column on the child table (e.g., 'userId') */
+    foreignKey: string;
+    /** Referenced column on the parent table (e.g., 'id') */
+    references: string;
+}
+/**
+ * Find a relation from child table to parent table.
+ * Uses Drizzle's relations metadata to discover foreign keys.
+ *
+ * @param schema - The Drizzle schema object
+ * @param childTableName - Name of the child table (e.g., 'posts')
+ * @param parentTableName - Name of the parent table (e.g., 'users')
+ * @returns Relation info or null if no relation found
+ */
+export declare function findRelation(schema: Record<string, unknown>, childTableName: string, parentTableName: string): RelationInfo | null;
+export {};
+//# sourceMappingURL=binding.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../../src/effect/binding.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAQ,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;;;;AAEzD;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,wBAAuC;IAC7E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB,CAAC;IACA,IAAI,OAAO,WAEV;CACF;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAA;IACb,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAa3D;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;;AAED;;;GAGG;AACH,qBAAa,WAAY,SAAQ,gBAG9B;CAAG;AAEN;;;;;;;;GAQG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,SAAS,MAAM,EACpC,KAAK,CAAC,KACL,MAAM,CAAC,MAAM,CACd,CAAC,SAAS,MAAM,oBAAoB,CAAC,QAAQ,CAAC,GAC1C,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,GAC7C,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,GACjD,OAAO,GACT,OAAO,EACX,kBAAkB,EAClB,WAAW,CAST,CAAA;AAEJ;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAS9C;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAA;IAClB,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,GACtB,YAAY,GAAG,IAAI,CA2CrB"}

package/dist/effect/binding.js

@@ -0,0 +1,169 @@
+/**
+ * Route Model Binding
+ *
+ * Laravel-style route model binding for Effect routes.
+ * Automatically resolves route parameters to database models.
+ */
+import { Context, Data, Effect } from 'effect';
+/**
+ * Error thrown when a bound model is not found in the BoundModels context.
+ * This indicates a programming error - the binding key doesn't match any resolved model.
+ */
+export class BoundModelNotFound extends Data.TaggedError('BoundModelNotFound') {
+    get message() {
+        return `No bound model found for key: '${this.key}'. Ensure the route uses {${this.key}} binding syntax.`;
+    }
+}
+/**
+ * Parse Laravel-style bindings from a route path.
+ *
+ * @example
+ * parseBindings('/users/{user}/posts/{post:slug}')
+ * // => [{ param: 'user', column: 'id' }, { param: 'post', column: 'slug' }]
+ */
+export function parseBindings(path) {
+    const regex = /\{(\w+)(?::(\w+))?\}/g;
+    const bindings = [];
+    let match;
+    while ((match = regex.exec(path)) !== null) {
+        bindings.push({
+            param: match[1],
+            column: match[2] ?? 'id',
+        });
+    }
+    return bindings;
+}
+/**
+ * Convert Laravel-style route to Hono-style route.
+ *
+ * @example
+ * toHonoPath('/users/{user}/posts/{post:slug}')
+ * // => '/users/:user/posts/:post'
+ */
+export function toHonoPath(path) {
+    return path.replace(/\{(\w+)(?::\w+)?\}/g, ':$1');
+}
+/**
+ * Service tag for bound models.
+ * Provides access to resolved route models in handlers.
+ */
+export class BoundModels extends Context.Tag('honertia/BoundModels')() {
+}
+/**
+ * Type-safe accessor for bound models.
+ *
+ * @example
+ * const showProject = Effect.gen(function* () {
+ *   const project = yield* bound('project')
+ *   return inertia('Projects/Show', { project })
+ * })
+ */
+export const bound = (key) => Effect.gen(function* () {
+    const models = yield* BoundModels;
+    const model = models.get(key);
+    if (!model) {
+        return yield* Effect.fail(new BoundModelNotFound({ key }));
+    }
+    return model;
+});
+/**
+ * Pluralize a singular word.
+ * Handles common English pluralization rules.
+ *
+ * @example
+ * pluralize('user')     // 'users'
+ * pluralize('category') // 'categories'
+ * pluralize('box')      // 'boxes'
+ * pluralize('class')    // 'classes'
+ */
+export function pluralize(word) {
+    // Words ending in vowel + y: just add 's' (day -> days)
+    if (/[aeiou]y$/i.test(word))
+        return word + 's';
+    // Words ending in consonant + y: replace y with ies (category -> categories)
+    if (/y$/i.test(word))
+        return word.slice(0, -1) + 'ies';
+    // Words ending in s, x, z, ch, sh: add 'es' (box -> boxes, class -> classes)
+    if (/(?:s|x|z|ch|sh)$/i.test(word))
+        return word + 'es';
+    // Default: add 's'
+    return word + 's';
+}
+/**
+ * Find a relation from child table to parent table.
+ * Uses Drizzle's relations metadata to discover foreign keys.
+ *
+ * @param schema - The Drizzle schema object
+ * @param childTableName - Name of the child table (e.g., 'posts')
+ * @param parentTableName - Name of the parent table (e.g., 'users')
+ * @returns Relation info or null if no relation found
+ */
+export function findRelation(schema, childTableName, parentTableName) {
+    // Look for relations definition (e.g., postsRelations)
+    const relationsKey = `${childTableName}Relations`;
+    const relations = schema[relationsKey];
+    if (!relations || typeof relations !== 'object') {
+        return null;
+    }
+    // Drizzle stores relations config - we need to inspect it
+    // The relations object has a config property with the relation definitions
+    const config = relations.config;
+    if (!config || typeof config !== 'function') {
+        return null;
+    }
+    // Try to extract relation info by calling the config
+    // This is a bit hacky but necessary to introspect Drizzle relations
+    try {
+        const relationDefs = config({
+            one: (table, opts) => ({ type: 'one', table, ...opts }),
+            many: (table, opts) => ({ type: 'many', table, ...opts }),
+        });
+        for (const [_name, rel] of Object.entries(relationDefs)) {
+            const relation = rel;
+            if (relation.type !== 'one')
+                continue;
+            // Check if this relation points to the parent table
+            const relatedTableName = getTableName(relation.table);
+            if (relatedTableName === parentTableName && relation.fields && relation.references) {
+                return {
+                    foreignKey: getColumnName(relation.fields[0]),
+                    references: getColumnName(relation.references[0]),
+                };
+            }
+        }
+    }
+    catch {
+        // If introspection fails, fall back to convention
+    }
+    return null;
+}
+/**
+ * Get table name from a Drizzle table object.
+ */
+function getTableName(table) {
+    if (table && typeof table === 'object') {
+        // Drizzle tables have a Symbol for the table name
+        const symbols = Object.getOwnPropertySymbols(table);
+        for (const sym of symbols) {
+            if (sym.description === 'drizzle:Name') {
+                return table[sym];
+            }
+        }
+        // Fallback: check for _ property
+        if ('_' in table && typeof table._ === 'object') {
+            return table._.name;
+        }
+    }
+    return '';
+}
+/**
+ * Get column name from a Drizzle column object.
+ */
+function getColumnName(column) {
+    if (column && typeof column === 'object') {
+        if ('name' in column) {
+            return column.name;
+        }
+    }
+    return '';
+}

package/dist/effect/bridge.d.ts

@@ -35,6 +35,18 @@ export interface EffectBridgeConfig<E extends Env, CustomServices = never> {
      * Return a Layer that provides your custom services.
      */
     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 })
+     * ```
+     */
+    schema?: Record<string, unknown>;
 }
 /**
  * Symbol for storing Effect runtime in 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,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,EAKvB,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;CAC5E;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,EAKvB,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"}

package/dist/effect/index.d.ts

@@ -11,6 +11,7 @@ export { effectBridge, buildContextLayer, getEffectRuntime, type EffectBridgeCon
 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';
-export { EffectRouteBuilder, effectRoutes, type EffectHandler, type BaseServices, } from './routing.js';
+export { EffectRouteBuilder, effectRoutes, type EffectHandler, type BaseServices, type EffectRouteOptions, } from './routing.js';
+export { BoundModels, BoundModelNotFound, bound, parseBindings, toHonoPath, type ParsedBinding, } from './binding.js';
 export { RequireAuthLayer, RequireGuestLayer, isAuthenticated, currentUser, requireAuth, requireGuest, shareAuth, shareAuthMiddleware, effectAuthRoutes, betterAuthFormAction, betterAuthLogoutAction, loadUser, type AuthRoutesConfig, type BetterAuthFormActionConfig, type BetterAuthLogoutConfig, type BetterAuthActionResult, } from './auth.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/effect/index.ts"],"names":[],"mappings":"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,GACtB,MAAM,eAAe,CAAA;AAGtB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,SAAS,EACT,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,GAClB,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,GACtB,MAAM,eAAe,CAAA;AAGtB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,SAAS,EACT,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,aAAa,EACb,UAAU,EACV,KAAK,aAAa,GACnB,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

@@ -21,5 +21,7 @@ export { action, authorize, dbMutation, dbTransaction, } from './action.js';
 export { redirect, render, renderWithErrors, json, text, notFound, forbidden, httpError, prefersJson, jsonOrRender, share, } from './responses.js';
 // Routing
 export { EffectRouteBuilder, effectRoutes, } from './routing.js';
+// Route Model Binding
+export { BoundModels, BoundModelNotFound, bound, parseBindings, toHonoPath, } from './binding.js';
 // Auth
 export { RequireAuthLayer, RequireGuestLayer, isAuthenticated, currentUser, requireAuth, requireGuest, shareAuth, shareAuthMiddleware, effectAuthRoutes, betterAuthFormAction, betterAuthLogoutAction, loadUser, } from './auth.js';

package/dist/effect/routing.d.ts

@@ -3,12 +3,12 @@
  *
  * Laravel-style routing with Effect handlers.
  */
-import { Effect, Layer } from 'effect';
+import { Effect, Layer, Schema as S } from 'effect';
 import type { Hono, Env } from 'hono';
 import { type EffectBridgeConfig } from './bridge.js';
-import type { AppError } from './errors.js';
-import { Redirect } from './errors.js';
+import { type AppError, Redirect } from './errors.js';
 import { DatabaseService, AuthService, HonertiaService, RequestService, ResponseFactoryService } from './services.js';
+import { BoundModels } from './binding.js';
 /**
  * Type for Effect-based route handlers.
  * Error type includes Error for compatibility with Effect.tryPromise.
@@ -17,7 +17,26 @@ export type EffectHandler<R = never, E extends AppError | Error = AppError | Err
 /**
  * Base services available in every route.
  */
-export type BaseServices = RequestService | ResponseFactoryService | HonertiaService | DatabaseService | AuthService;
+export type BaseServices = RequestService | ResponseFactoryService | HonertiaService | DatabaseService | AuthService | BoundModels;
+/**
+ * Route-level configuration options.
+ */
+export interface EffectRouteOptions {
+    /**
+     * Validate route params with the provided schema.
+     * Invalid values will return a 404 before the handler runs.
+     *
+     * @example
+     * ```typescript
+     * effectRoutes(app).get(
+     *   '/projects/{project}',
+     *   showProject,
+     *   { params: S.Struct({ project: uuid }) }
+     * )
+     * ```
+     */
+    params?: S.Schema.Any;
+}
 /**
  * Effect Route Builder with layer composition.
  */
@@ -45,33 +64,32 @@ export declare class EffectRouteBuilder<E extends Env, ProvidedServices = never,
      */
     private resolvePath;
     /**
-     * Create a Hono handler from an Effect.
-     */
-    private createHandler;
-    /**
-     * Register a GET route.
+     * Validate route params against a schema.
      */
-    get<R extends BaseServices | ProvidedServices | CustomServices>(path: string, effect: EffectHandler<R, AppError | Error>): void;
+    private ensureParams;
     /**
-     * Register a POST route.
+     * Resolve route model bindings from the database.
+     * Returns a Map of binding names to resolved models, or a 404 Response if any binding fails.
      */
-    post<R extends BaseServices | ProvidedServices | CustomServices>(path: string, effect: EffectHandler<R, AppError | Error>): void;
-    /**
-     * Register a PUT route.
-     */
-    put<R extends BaseServices | ProvidedServices | CustomServices>(path: string, effect: EffectHandler<R, AppError | Error>): void;
-    /**
-     * Register a PATCH route.
-     */
-    patch<R extends BaseServices | ProvidedServices | CustomServices>(path: string, effect: EffectHandler<R, AppError | Error>): void;
-    /**
-     * Register a DELETE route.
-     */
-    delete<R extends BaseServices | ProvidedServices | CustomServices>(path: string, effect: EffectHandler<R, AppError | Error>): void;
+    private resolveBindings;
+    private createHandler;
     /**
-     * Register a route for all HTTP methods.
+     * Register a route with the given HTTP method.
+     * Parses Laravel-style bindings and converts to Hono path format.
      */
-    all<R extends BaseServices | ProvidedServices | CustomServices>(path: string, effect: EffectHandler<R, AppError | Error>): void;
+    private registerRoute;
+    /** Register a GET route. Supports Laravel-style route model binding: /projects/{project} */
+    get<R extends BaseServices | ProvidedServices | CustomServices>(path: string, effect: EffectHandler<R, AppError | Error>, options?: EffectRouteOptions): void;
+    /** Register a POST route. Supports Laravel-style route model binding: /projects/{project} */
+    post<R extends BaseServices | ProvidedServices | CustomServices>(path: string, effect: EffectHandler<R, AppError | Error>, options?: EffectRouteOptions): void;
+    /** Register a PUT route. Supports Laravel-style route model binding: /projects/{project} */
+    put<R extends BaseServices | ProvidedServices | CustomServices>(path: string, effect: EffectHandler<R, AppError | Error>, options?: EffectRouteOptions): void;
+    /** Register a PATCH route. Supports Laravel-style route model binding: /projects/{project} */
+    patch<R extends BaseServices | ProvidedServices | CustomServices>(path: string, effect: EffectHandler<R, AppError | Error>, options?: EffectRouteOptions): void;
+    /** Register a DELETE route. Supports Laravel-style route model binding: /projects/{project} */
+    delete<R extends BaseServices | ProvidedServices | CustomServices>(path: string, effect: EffectHandler<R, AppError | Error>, options?: EffectRouteOptions): void;
+    /** Register a route for all HTTP methods. Supports Laravel-style route model binding: /projects/{project} */
+    all<R extends BaseServices | ProvidedServices | CustomServices>(path: string, effect: EffectHandler<R, AppError | Error>, options?: EffectRouteOptions): void;
 }
 /**
  * Create an Effect route builder for an app.

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

@@ -1 +1 @@
-{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../src/effect/routing.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AACtC,OAAO,KAAK,EAAE,IAAI,EAAqB,GAAG,EAAE,MAAM,MAAM,CAAA;AAExD,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAA;AACxE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,OAAO,EACL,eAAe,EACf,WAAW,EACX,eAAe,EACf,cAAc,EACd,sBAAsB,EACvB,MAAM,eAAe,CAAA;AAEtB;;;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,CAAA;AAEf;;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;IACH,OAAO,CAAC,aAAa;IAwBrB;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,YAAY,GAAG,gBAAgB,GAAG,cAAc,EAAM,IAAI,EAAE,MAAM,EAC9E,MAAM,EAAE,aAAa,CAAC,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC,GACzC,IAAI;IAIP;;OAEG;IACH,IAAI,CAAC,CAAC,SAAS,YAAY,GAAG,gBAAgB,GAAG,cAAc,EAC7D,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,aAAa,CAAC,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC,GACzC,IAAI;IAIP;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,YAAY,GAAG,gBAAgB,GAAG,cAAc,EAC5D,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,aAAa,CAAC,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC,GACzC,IAAI;IAIP;;OAEG;IACH,KAAK,CAAC,CAAC,SAAS,YAAY,GAAG,gBAAgB,GAAG,cAAc,EAC9D,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,aAAa,CAAC,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC,GACzC,IAAI;IAIP;;OAEG;IACH,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,GACzC,IAAI;IAIP;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,YAAY,GAAG,gBAAgB,GAAG,cAAc,EAC5D,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,aAAa,CAAC,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC,GACzC,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"}
+{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../src/effect/routing.ts"],"names":[],"mappings":"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"}

package/dist/effect/routing.js

@@ -3,9 +3,10 @@
  *
  * Laravel-style routing with Effect handlers.
  */
-import { Effect, Layer } from 'effect';
+import { Effect, Exit, Layer, Schema as S } from 'effect';
 import { effectHandler } from './handler.js';
 import { buildContextLayer } from './bridge.js';
+import { parseBindings, toHonoPath, pluralize, findRelation, BoundModels, } from './binding.js';
 /**
  * Effect Route Builder with layer composition.
  */
@@ -50,16 +51,97 @@ export class EffectRouteBuilder {
         return path;
     }
     /**
-     * Create a Hono handler from an Effect.
+     * Validate route params against a schema.
      */
-    createHandler(effect) {
+    async ensureParams(c, schema) {
+        if (!schema)
+            return null;
+        const rawParams = c.req.param();
+        const params = typeof rawParams === 'string' ? {} : rawParams;
+        const decode = S.decodeUnknown(schema);
+        const exit = await Effect.runPromiseExit(decode(params));
+        if (Exit.isFailure(exit)) {
+            return c.notFound();
+        }
+        return null;
+    }
+    /**
+     * Resolve route model bindings from the database.
+     * Returns a Map of binding names to resolved models, or a 404 Response if any binding fails.
+     */
+    async resolveBindings(c, bindings, db, schema) {
+        if (bindings.length === 0) {
+            return new Map();
+        }
+        // Dynamic import to avoid requiring drizzle-orm for non-binding users
+        const { eq } = await import('drizzle-orm');
+        const models = new Map();
+        let parent = null;
+        for (const binding of bindings) {
+            const tableName = pluralize(binding.param);
+            const table = schema[tableName];
+            if (!table) {
+                return c.notFound();
+            }
+            const paramValue = c.req.param(binding.param);
+            if (!paramValue) {
+                return c.notFound();
+            }
+            // Build query with primary lookup
+            const column = table[binding.column];
+            if (!column) {
+                return c.notFound();
+            }
+            const dbClient = db;
+            let query = dbClient.select().from(table).where(eq(column, paramValue));
+            // If we have a parent, try to scope the query
+            if (parent) {
+                const relation = findRelation(schema, tableName, parent.tableName);
+                if (relation) {
+                    const foreignKeyColumn = table[relation.foreignKey];
+                    if (foreignKeyColumn && parent.model[relation.references]) {
+                        query = query.where(eq(foreignKeyColumn, parent.model[relation.references]));
+                    }
+                }
+            }
+            // Execute the query
+            const result = await query.get();
+            if (!result) {
+                return c.notFound();
+            }
+            models.set(binding.param, result);
+            parent = { tableName, model: result };
+        }
+        return models;
+    }
+    createHandler(effect, bindings, options) {
         const layers = this.layers;
         const bridgeConfig = this.bridgeConfig;
         return async (c) => {
+            const validation = await this.ensureParams(c, options?.params);
+            if (validation)
+                return validation;
             // Build context layer from Hono context
             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;
+                if (!db) {
+                    return c.notFound();
+                }
+                const result = await this.resolveBindings(c, bindings, db, bridgeConfig.schema);
+                if (result instanceof Response) {
+                    return result;
+                }
+                boundModelsLayer = Layer.succeed(BoundModels, result);
+            }
+            else {
+                // Empty bound models for routes without bindings
+                boundModelsLayer = Layer.succeed(BoundModels, new Map());
+            }
             // Combine with provided layers
-            let fullLayer = contextLayer;
+            let fullLayer = Layer.merge(contextLayer, boundModelsLayer);
             for (const layer of layers) {
                 fullLayer = Layer.merge(fullLayer, layer);
             }
@@ -70,40 +152,37 @@ export class EffectRouteBuilder {
         };
     }
     /**
-     * Register a GET route.
+     * Register a route with the given HTTP method.
+     * Parses Laravel-style bindings and converts to Hono path format.
      */
-    get(path, effect) {
-        this.app.get(this.resolvePath(path), this.createHandler(effect));
+    registerRoute(method, path, effect, options) {
+        const bindings = parseBindings(path);
+        const honoPath = toHonoPath(path);
+        this.app[method](this.resolvePath(honoPath), this.createHandler(effect, bindings, options));
     }
-    /**
-     * Register a POST route.
-     */
-    post(path, effect) {
-        this.app.post(this.resolvePath(path), this.createHandler(effect));
+    /** Register a GET route. Supports Laravel-style route model binding: /projects/{project} */
+    get(path, effect, options) {
+        this.registerRoute('get', path, effect, options);
     }
-    /**
-     * Register a PUT route.
-     */
-    put(path, effect) {
-        this.app.put(this.resolvePath(path), this.createHandler(effect));
+    /** Register a POST route. Supports Laravel-style route model binding: /projects/{project} */
+    post(path, effect, options) {
+        this.registerRoute('post', path, effect, options);
     }
-    /**
-     * Register a PATCH route.
-     */
-    patch(path, effect) {
-        this.app.patch(this.resolvePath(path), this.createHandler(effect));
+    /** Register a PUT route. Supports Laravel-style route model binding: /projects/{project} */
+    put(path, effect, options) {
+        this.registerRoute('put', path, effect, options);
     }
-    /**
-     * Register a DELETE route.
-     */
-    delete(path, effect) {
-        this.app.delete(this.resolvePath(path), this.createHandler(effect));
+    /** Register a PATCH route. Supports Laravel-style route model binding: /projects/{project} */
+    patch(path, effect, options) {
+        this.registerRoute('patch', path, effect, options);
     }
-    /**
-     * Register a route for all HTTP methods.
-     */
-    all(path, effect) {
-        this.app.all(this.resolvePath(path), this.createHandler(effect));
+    /** Register a DELETE route. Supports Laravel-style route model binding: /projects/{project} */
+    delete(path, effect, options) {
+        this.registerRoute('delete', path, effect, options);
+    }
+    /** Register a route for all HTTP methods. Supports Laravel-style route model binding: /projects/{project} */
+    all(path, effect, options) {
+        this.registerRoute('all', path, effect, options);
     }
 }
 /**

package/dist/effect/services.d.ts

@@ -14,6 +14,7 @@ import { Context } from 'effect';
  * declare module 'honertia/effect' {
  *   interface HonertiaDatabaseType {
  *     type: Database // Your database type (Drizzle, Prisma, Kysely, etc.)
+ *     schema: typeof schema // Your Drizzle schema for route model binding
  *   }
  * }
  * ```
@@ -21,7 +22,8 @@ import { Context } from 'effect';
  * Then use the `DatabaseService` tag to get your typed database.
  */
 export interface HonertiaDatabaseType {
-    [key: string]: unknown;
+    type: unknown;
+    schema: Record<string, unknown>;
 }
 /**
  * Augmentable interface for auth type.

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "honertia",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "Inertia.js-style server-driven SPA adapter for Hono",
   "type": "module",
   "main": "./dist/index.js",
@@ -60,11 +60,21 @@
   },
   "peerDependencies": {
     "hono": ">=4.0.0",
-    "better-auth": ">=1.0.0"
+    "better-auth": ">=1.0.0",
+    "drizzle-orm": ">=0.30.0"
+  },
+  "peerDependenciesMeta": {
+    "better-auth": {
+      "optional": true
+    },
+    "drizzle-orm": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@types/bun": "^1.1.0",
     "better-auth": "^1.0.0",
+    "drizzle-orm": "^0.38.0",
     "hono": "^4.6.0",
     "typescript": "^5.3.0"
   }