honertia 0.1.0 → 0.1.1

package/README.md

@@ -1,8 +1,18 @@
 # Honertia
 
 [![npm version](https://img.shields.io/npm/v/honertia.svg)](https://www.npmjs.com/package/honertia)
+[![Bundle Size](https://img.shields.io/bundlephobia/minzip/honertia)](https://bundlephobia.com/package/honertia)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue.svg)](https://www.typescriptlang.org/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
+[![Hono](https://img.shields.io/badge/Hono-E36002?logo=hono&logoColor=fff)](https://hono.dev/)
+[![Cloudflare Workers](https://img.shields.io/badge/Cloudflare%20Workers-F38020?logo=cloudflare&logoColor=fff)](https://workers.cloudflare.com/)
+[![Effect](https://img.shields.io/badge/Effect-TS-black)](https://effect.website/)
+
+## Raison d'être
+
+I've found myself wanting to use Cloudflare Workers for everything, but having come from a Laravel background nothing quite matched the DX and simplicity of Laravel x Inertia.js. When building Laravel projects I would always use Loris Leiva's laravel-actions package among other opinionated architecture decisions such as Vite, Tailwind, Bun, React etc., all of which have or will be incorporated into this project. With Cloudflare Workers the obvious choice is Hono and so we've adapted the Inertia.js protocol to run on workers+hono to mimic a Laravel-style app. Ever since learning of Effect.ts I've known that I wanted to use it for something bigger, and so we've utilised it here. Ultimately this is a workers+hono+vite+bun+laravel+inertia+effect+betterauth+planetscale mashup that delivers clean, readable, and powerful web app scaffolding.
+
 An Inertia.js-style adapter for Hono with Effect.js integration. Build full-stack applications with type-safe server actions, Laravel-inspired validation, and seamless React rendering.
 
 ## Requirements
@@ -25,157 +35,142 @@ bun add honertia
 ```typescript
 // src/index.ts
 import { Hono } from 'hono'
-import {
-  honertia,
-  createTemplate,
-  loadUser,
-  shareAuthMiddleware,
-  effectBridge,
-  effectRoutes,
-  effectAuthRoutes,
-  RequireAuthLayer,
-} from 'honertia'
+import { logger } from 'hono/logger'
+import { setupHonertia, createTemplate, registerErrorHandlers, vite } from 'honertia'
+import { Context, Layer } from 'effect'
 
-const app = new Hono()
+import { createDb } from './db'
+import type { Env } from './types'
+import { createAuth } from './lib/auth'
+import { registerRoutes } from './routes'
 
-// Core middleware
-app.use('*', honertia({
-  version: '1.0.0',
-  render: createTemplate({
-    title: 'My App',
-    scripts: ['http://localhost:5173/src/main.tsx'],
-  }),
-}))
+const app = new Hono<Env>()
+
+class BindingsService extends Context.Tag('app/Bindings')<
+  BindingsService,
+  { KV: KVNamespace }
+>() {}
 
-// Database & Auth setup (your own middleware)
+// Database & Auth
 app.use('*', async (c, next) => {
   c.set('db', createDb(c.env.DATABASE_URL))
-  c.set('auth', createAuth({ /* config */ }))
+  c.set('auth', createAuth({
+    db: c.var.db,
+    secret: c.env.BETTER_AUTH_SECRET,
+    baseURL: new URL(c.req.url).origin,
+  }))
   await next()
 })
 
-// Auth middleware
-app.use('*', loadUser())
-app.use('*', shareAuthMiddleware())
-
-// Effect bridge (sets up Effect runtime per request)
-app.use('*', effectBridge())
-
-// Register routes
-effectAuthRoutes(app, {
-  loginComponent: 'Auth/Login',
-  registerComponent: 'Auth/Register',
-})
-
-effectRoutes(app)
-  .provide(RequireAuthLayer)
-  .group((route) => {
-    route.get('/', showDashboard)
-    route.get('/projects', listProjects)
-    route.post('/projects', createProject)
-  })
-
-export default app
-```
-
-### Using `setupHonertia` (Recommended)
-
-For a cleaner setup, use `setupHonertia` which bundles all core middleware into a single call:
-
-```typescript
-import { Hono } from 'hono'
-import { setupHonertia, createTemplate, effectRoutes } from 'honertia'
-
-const app = new Hono()
-
-app.use('*', setupHonertia({
+// Honertia (bundles core middleware, auth loading, and Effect bridge)
+app.use('*', setupHonertia<Env, BindingsService>({
   honertia: {
     version: '1.0.0',
-    render: createTemplate({
-      title: 'My App',
-      scripts: ['http://localhost:5173/src/main.tsx'],
+    render: createTemplate((ctx) => {
+      const isProd = ctx.env.ENVIRONMENT === 'production'
+      return {
+        title: 'Dashboard',
+        scripts: isProd ? ['/assets/main.js'] : [vite.script()],
+        head: isProd ? '' : vite.hmrHead(),
+      }
     }),
   },
-  auth: {
-    userKey: 'user',
-    sessionCookie: 'session',
-  },
   effect: {
-    // Effect bridge configuration
+    services: (c) => Layer.succeed(BindingsService, {
+      KV: c.env.MY_KV,
+    }),
   },
+  middleware: [
+    logger(),
+    // register additional middleware here...
+  ],
 }))
 
+registerRoutes(app)
+registerErrorHandlers(app)
+
 export default app
 ```
 
-This is equivalent to manually registering:
-- `honertia()` - Core Honertia middleware
-- `loadUser()` - Loads authenticated user into context
-- `shareAuthMiddleware()` - Shares auth state with pages
-- `effectBridge()` - Sets up Effect runtime for each request
+```typescript
+// src/routes.ts
+import type { Hono } from 'hono'
+import type { Env } from './types'
+import { effectRoutes } from 'honertia/effect'
+import { effectAuthRoutes, RequireAuthLayer } from 'honertia/auth'
+import { showDashboard, listProjects, createProject, showProject, deleteProject } from './actions'
+
+export function registerRoutes(app: Hono<Env>) {
+  // Auth routes (login, register, logout, API handler)
+  effectAuthRoutes(app, {
+    loginComponent: 'Auth/Login',
+    registerComponent: 'Auth/Register',
+  })
 
-#### Adding Custom Middleware
+  // Routes that require the user to be authenticated
+  effectRoutes(app)
+    .provide(RequireAuthLayer)
+    .group((route) => {
+      route.get('/', showDashboard) // GET example.com
+
+      route.prefix('/projects').group((route) => {
+        route.get('/', listProjects)        // GET    example.com/projects
+        route.post('/', createProject)      // POST   example.com/projects
+        route.get('/:id', showProject)      // GET    example.com/projects/2
+        route.delete('/:id', deleteProject) // DELETE example.com/projects/2
+      })
+    })
+}
+```
 
-You can inject additional middleware that runs after the core setup:
+### Example Action
+
+Here's the `listProjects` action referenced above:
 
 ```typescript
-import { cors } from 'hono/cors'
-import { logger } from 'hono/logger'
+// src/actions/projects/list.ts
+import { Effect } from 'effect'
+import { eq } from 'drizzle-orm'
+import { DatabaseService, AuthUserService, render, type AuthUser } from 'honertia/effect'
+import { schema, type Database, type Project } from '../../db'
 
-app.use('*', setupHonertia({
-  honertia: {
-    version: '1.0.0',
-    render: createTemplate({ title: 'My App', scripts: [...] }),
-  },
-  middleware: [
-    cors(),
-    logger(),
-    myCustomMiddleware(),
-  ],
-}))
-```
+interface ProjectsIndexProps {
+  projects: Project[]
+}
 
-The custom middleware runs in order after `effectBridge`, giving you access to all Honertia context variables.
+const fetchProjects = (
+  db: Database,
+  user: AuthUser
+): Effect.Effect<ProjectsIndexProps, Error, never> =>
+  Effect.tryPromise({
+    try: async () => {
+      const projects = await db.query.projects.findMany({
+        where: eq(schema.projects.userId, user.user.id),
+        orderBy: (projects, { desc }) => [desc(projects.createdAt)],
+      })
+      return { projects }
+    },
+    catch: (error) => error instanceof Error ? error : new Error(String(error)),
+  })
 
-#### Environment-Aware Templates
+export const listProjects = Effect.gen(function* () {
+  const db = yield* DatabaseService
+  const user = yield* AuthUserService
+  const props = yield* fetchProjects(db as Database, user)
+  return yield* render('Dashboard/Projects/Index', props)
+})
+```
+
+### Vite Helpers
 
-`createTemplate` can accept a function that receives the Hono context, enabling environment-specific configuration:
+The `vite` helper provides dev/prod asset management:
 
 ```typescript
-const viteHmrHead = `
-  <script type="module">
-    import RefreshRuntime from 'http://localhost:5173/@react-refresh'
-    RefreshRuntime.injectIntoGlobalHook(window)
-    window.$RefreshReg$ = () => {}
-    window.$RefreshSig$ = () => (type) => type
-    window.__vite_plugin_react_preamble_installed__ = true
-  </script>
-  <script type="module" src="http://localhost:5173/@vite/client"></script>
-`
-
-app.use('*', setupHonertia({
-  honertia: {
-    version: '1.0.0',
-    render: createTemplate((ctx) => {
-      const isProd = ctx.env.ENVIRONMENT === 'production'
-      return {
-        title: 'My App',
-        scripts: isProd
-          ? ['/assets/main.js']
-          : ['http://localhost:5173/src/main.tsx'],
-        head: isProd
-          ? '<link rel="icon" href="/favicon.svg" />'
-          : `${viteHmrHead}<link rel="icon" href="/favicon.svg" />`,
-      }
-    }),
-  },
-}))
-```
+import { vite } from 'honertia'
 
-This pattern allows you to:
-- Use Vite HMR in development, built assets in production
-- Access environment variables from `ctx.env`
-- Dynamically configure any template option based on request context
+vite.script()   // 'http://localhost:5173/src/main.tsx'
+vite.hmrHead()  // HMR preamble script tags for React Fast Refresh
+```
 
 ## Core Concepts
 
@@ -237,6 +232,91 @@ Honertia provides these services via Effect's dependency injection:
 | `RequestService` | Request context (params, query, body) |
 | `ResponseFactoryService` | Response builders |
 
+#### Custom Services
+
+You can inject Cloudflare Worker bindings (KV, D1, Queues, Analytics Engine) as services using the `services` option in `setupHonertia`, `effectBridge`, or `effectRoutes`.
+
+Choose the option that matches your setup:
+
+- `setupHonertia`: recommended for most apps; keeps config in one place and applies services to every Effect handler.
+- `effectBridge`: use when wiring middleware manually or when you need precise middleware ordering; applies services to all Effect handlers.
+- `effectRoutes`: use when you want services scoped to a route group or different services per group.
+
+```typescript
+import { Effect, Layer, Context } from 'effect'
+import { setupHonertia, effectBridge, effectRoutes } from 'honertia'
+
+// Define your custom service
+export class BindingsService extends Context.Tag('app/Bindings')<
+  BindingsService,
+  {
+    KV: KVNamespace
+    ANALYTICS: AnalyticsEngineDataset
+    DB: D1Database
+  }
+>() {}
+
+// Option 1: setupHonertia (global services via the one-liner setup)
+app.use('*', setupHonertia<Env, BindingsService>({
+  honertia: {
+    version: '1.0.0',
+    render: (page) => JSON.stringify(page),
+  },
+  effect: {
+    services: (c) => Layer.succeed(BindingsService, {
+      KV: c.env.MY_KV,
+      ANALYTICS: c.env.ANALYTICS,
+      DB: c.env.DB,
+    }),
+  },
+}))
+
+// Option 2: effectBridge (manual middleware wiring)
+app.use('*', effectBridge<Env, BindingsService>({
+  database: (c) => createDb(c.env.DATABASE_URL),
+  services: (c) => Layer.succeed(BindingsService, {
+    KV: c.env.MY_KV,
+    ANALYTICS: c.env.ANALYTICS,
+    DB: c.env.DB,
+  }),
+}))
+
+// Option 3: effectRoutes (scoped to a route group)
+effectRoutes<Env, BindingsService>(app, {
+  services: (c) => Layer.succeed(BindingsService, {
+    KV: c.env.MY_KV,
+    ANALYTICS: c.env.ANALYTICS,
+    DB: c.env.DB,
+  }),
+}).group((route) => {
+  route.get('/data', getDataFromKV)
+})
+
+// Use the custom service in your actions
+const getDataFromKV = Effect.gen(function* () {
+  const bindings = yield* BindingsService
+  const value = yield* Effect.tryPromise(() =>
+    bindings.KV.get('my-key')
+  )
+  return yield* json({ value })
+})
+```
+
+You can provide multiple bindings in any option using `Layer.mergeAll` (for example, a `QueueService` tag for a queue binding):
+
+```typescript
+app.use('*', effectBridge<Env, BindingsService | QueueService>({
+  services: (c) => Layer.mergeAll(
+    Layer.succeed(BindingsService, {
+      KV: c.env.MY_KV,
+      ANALYTICS: c.env.ANALYTICS,
+      DB: c.env.DB,
+    }),
+    Layer.succeed(QueueService, c.env.MY_QUEUE),
+  ),
+}))
+```
+
 ### Routing
 
 Use `effectRoutes` for Laravel-style route definitions:

package/dist/effect/bridge.d.ts

@@ -8,9 +8,33 @@ import type { Context as HonoContext, MiddlewareHandler, Env } from 'hono';
 import { DatabaseService, AuthService, AuthUserService, HonertiaService, RequestService, ResponseFactoryService } from './services.js';
 /**
  * Configuration for the Effect bridge.
+ *
+ * @typeParam E - Hono environment type
+ * @typeParam CustomServices - Custom services provided via the `services` option
+ *
+ * @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),
+ * })
+ *
+ * @example
+ * // Provide multiple custom services
+ * effectBridge<Env, BindingsService | LoggerService>({
+ *   services: (c) => Layer.mergeAll(
+ *     Layer.succeed(BindingsService, c.env),
+ *     Layer.succeed(LoggerService, createLogger(c)),
+ *   ),
+ * })
  */
-export interface EffectBridgeConfig<E extends Env> {
+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.
+     */
+    services?: (c: HonoContext<E>) => Layer.Layer<CustomServices, never, never>;
 }
 /**
  * Symbol for storing Effect runtime in Hono context.
@@ -27,7 +51,7 @@ declare module 'hono' {
 /**
  * Build the Effect layer from Hono context.
  */
-export declare function buildContextLayer<E extends Env>(c: HonoContext<E>, config?: EffectBridgeConfig<E>): Layer.Layer<RequestService | ResponseFactoryService | HonertiaService | DatabaseService | AuthService | AuthUserService, 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 | CustomServices, never, never>;
 /**
  * Get the Effect runtime from Hono context.
  */
@@ -35,6 +59,6 @@ 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>(config?: EffectBridgeConfig<E>): MiddlewareHandler<E>;
+export declare function effectBridge<E extends Env, CustomServices = never>(config?: EffectBridgeConfig<E, CustomServices>): MiddlewareHandler<E>;
 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,EAAU,KAAK,EAAE,cAAc,EAAW,MAAM,QAAQ,CAAA;AAC/D,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;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,GAAG;IAC/C,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,OAAO,CAAA;CAC1C;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,EAC7C,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,EACjB,MAAM,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC7B,KAAK,CAAC,KAAK,CACV,cAAc,GACd,sBAAsB,GACtB,eAAe,GACf,eAAe,GACf,WAAW,GACX,eAAe,EACjB,KAAK,EACL,KAAK,CACN,CAmCA;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,EACxC,MAAM,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC7B,iBAAiB,CAAC,CAAC,CAAC,CAetB"}
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../src/effect/bridge.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAU,KAAK,EAAE,cAAc,EAAW,MAAM,QAAQ,CAAA;AAC/D,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"}

package/dist/effect/bridge.js

@@ -75,6 +75,11 @@ export function buildContextLayer(c, config) {
     if (c.var?.authUser) {
         baseLayer = Layer.merge(baseLayer, Layer.succeed(AuthUserService, c.var.authUser));
     }
+    // Merge custom services if provided
+    if (config?.services) {
+        const customServicesLayer = config.services(c);
+        baseLayer = Layer.merge(baseLayer, customServicesLayer);
+    }
     return baseLayer;
 }
 /**

package/dist/effect/routing.d.ts

@@ -21,25 +21,25 @@ export type BaseServices = RequestService | ResponseFactoryService | HonertiaSer
 /**
  * Effect Route Builder with layer composition.
  */
-export declare class EffectRouteBuilder<E extends Env, ProvidedServices = never> {
+export declare class EffectRouteBuilder<E extends Env, ProvidedServices = never, CustomServices = never> {
     private readonly app;
     private readonly layers;
     private readonly pathPrefix;
     private readonly bridgeConfig?;
-    constructor(app: Hono<E>, layers?: Layer.Layer<any, never, never>[], pathPrefix?: string, bridgeConfig?: EffectBridgeConfig<E> | undefined);
+    constructor(app: Hono<E>, layers?: Layer.Layer<any, never, never>[], pathPrefix?: string, bridgeConfig?: EffectBridgeConfig<E, CustomServices> | undefined);
     /**
      * Add a layer to provide services to all routes in this builder.
      * The layer's error type must be handled by the effect bridge (AppError or subtype).
      */
-    provide<S, LayerErr extends AppError>(layer: Layer.Layer<S, LayerErr, never>): EffectRouteBuilder<E, ProvidedServices | S>;
+    provide<S, LayerErr extends AppError>(layer: Layer.Layer<S, LayerErr, never>): EffectRouteBuilder<E, ProvidedServices | S, CustomServices>;
     /**
      * Set path prefix for all routes in this builder.
      */
-    prefix(path: string): EffectRouteBuilder<E, ProvidedServices>;
+    prefix(path: string): EffectRouteBuilder<E, ProvidedServices, CustomServices>;
     /**
      * Create a nested group with the same configuration.
      */
-    group(callback: (route: EffectRouteBuilder<E, ProvidedServices>) => void): void;
+    group(callback: (route: EffectRouteBuilder<E, ProvidedServices, CustomServices>) => void): void;
     /**
      * Resolve the full path.
      */
@@ -51,27 +51,27 @@ export declare class EffectRouteBuilder<E extends Env, ProvidedServices = never>
     /**
      * Register a GET route.
      */
-    get<R extends BaseServices | ProvidedServices>(path: string, effect: EffectHandler<R, AppError | Error>): void;
+    get<R extends BaseServices | ProvidedServices | CustomServices>(path: string, effect: EffectHandler<R, AppError | Error>): void;
     /**
      * Register a POST route.
      */
-    post<R extends BaseServices | ProvidedServices>(path: string, effect: EffectHandler<R, AppError | Error>): void;
+    post<R extends BaseServices | ProvidedServices | CustomServices>(path: string, effect: EffectHandler<R, AppError | Error>): void;
     /**
      * Register a PUT route.
      */
-    put<R extends BaseServices | ProvidedServices>(path: string, effect: EffectHandler<R, AppError | Error>): void;
+    put<R extends BaseServices | ProvidedServices | CustomServices>(path: string, effect: EffectHandler<R, AppError | Error>): void;
     /**
      * Register a PATCH route.
      */
-    patch<R extends BaseServices | ProvidedServices>(path: string, effect: EffectHandler<R, AppError | Error>): void;
+    patch<R extends BaseServices | ProvidedServices | CustomServices>(path: string, effect: EffectHandler<R, AppError | Error>): void;
     /**
      * Register a DELETE route.
      */
-    delete<R extends BaseServices | ProvidedServices>(path: string, effect: EffectHandler<R, AppError | Error>): void;
+    delete<R extends BaseServices | ProvidedServices | CustomServices>(path: string, effect: EffectHandler<R, AppError | Error>): void;
     /**
      * Register a route for all HTTP methods.
      */
-    all<R extends BaseServices | ProvidedServices>(path: string, effect: EffectHandler<R, AppError | Error>): void;
+    all<R extends BaseServices | ProvidedServices | CustomServices>(path: string, effect: EffectHandler<R, AppError | Error>): void;
 }
 /**
  * Create an Effect route builder for an app.
@@ -86,5 +86,5 @@ export declare class EffectRouteBuilder<E extends Env, ProvidedServices = never>
  *     route.post('/projects', createProject)
  *   })
  */
-export declare function effectRoutes<E extends Env>(app: Hono<E>, config?: EffectBridgeConfig<E>): EffectRouteBuilder<E, never>;
+export declare function effectRoutes<E extends Env, CustomServices = never>(app: Hono<E>, config?: EffectBridgeConfig<E, CustomServices>): EffectRouteBuilder<E, never, CustomServices>;
 //# sourceMappingURL=routing.d.ts.map

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

package/dist/setup.d.ts

@@ -10,7 +10,7 @@ import { type EffectBridgeConfig } from './effect/bridge.js';
 /**
  * Configuration for Honertia setup.
  */
-export interface HonertiaSetupConfig<E extends Env = Env> {
+export interface HonertiaSetupConfig<E extends Env = Env, CustomServices = never> {
     /**
      * Honertia core configuration.
      */
@@ -18,7 +18,7 @@ export interface HonertiaSetupConfig<E extends Env = Env> {
     /**
      * Effect bridge configuration (optional).
      */
-    effect?: EffectBridgeConfig<E>;
+    effect?: EffectBridgeConfig<E, CustomServices>;
     /**
      * Auth configuration (optional).
      */
@@ -53,7 +53,7 @@ export interface HonertiaSetupConfig<E extends Env = Env> {
  * }))
  * ```
  */
-export declare function setupHonertia<E extends Env>(config: HonertiaSetupConfig<E>): MiddlewareHandler<E>;
+export declare function setupHonertia<E extends Env, CustomServices = never>(config: HonertiaSetupConfig<E, CustomServices>): MiddlewareHandler<E>;
 /**
  * Error handler configuration.
  */

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;IACtD;;OAEG;IACH,QAAQ,EAAE,cAAc,CAAA;IAExB;;OAEG;IACH,MAAM,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAA;IAE9B;;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,EACzC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC7B,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,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"}

package/package.json

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