honertia 0.1.0 → 0.1.2

package/README.md

@@ -1,18 +1,21 @@
 # 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)
 
-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.
+[![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/)
 
-## Requirements
+## Overview
 
-- **Runtime**: Node.js 18+ or Bun 1.0+
-- **Peer Dependencies**:
-  - `hono` >= 4.0.0
-  - `better-auth` >= 1.0.0
-- **Dependencies**:
-  - `effect` >= 3.12.0
+An Inertia.js-style adapter for Hono with Effect.js integration. Inertia keeps a server-driven app but behaves like an SPA: link clicks and form posts are intercepted, a fetch/XHR request returns a JSON page object (component + props), and the client swaps the page without a full reload. Honertia layers Laravel-style route patterns and Effect actions on top of that so handlers stay clean, readable, and composable.
+
+## 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.
 
 ## Installation
 
@@ -25,157 +28,400 @@ bun add honertia
 ```typescript
 // src/index.ts
 import { Hono } from 'hono'
-import {
-  honertia,
-  createTemplate,
-  loadUser,
-  shareAuthMiddleware,
-  effectBridge,
-  effectRoutes,
-  effectAuthRoutes,
-  RequireAuthLayer,
-} from 'honertia'
-
-const app = new Hono()
-
-// Core middleware
-app.use('*', honertia({
-  version: '1.0.0',
-  render: createTemplate({
-    title: 'My App',
-    scripts: ['http://localhost:5173/src/main.tsx'],
-  }),
-}))
-
-// Database & Auth setup (your own middleware)
+import { logger } from 'hono/logger'
+import { setupHonertia, createTemplate, createVersion, registerErrorHandlers, vite } from 'honertia'
+import { Context, Layer } from 'effect'
+import manifest from '../dist/manifest.json'
+
+import { createDb } from './db'
+import type { Env } from './types'
+import { createAuth } from './lib/auth'
+import { registerRoutes } from './routes'
+
+const app = new Hono<Env>()
+const assetVersion = createVersion(manifest)
+const entry = manifest['src/main.tsx']
+const assetPath = (path: string) => `/${path}`
+
+class BindingsService extends Context.Tag('app/Bindings')<
+  BindingsService,
+  { 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({ /* 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())
+// Honertia bundles the core middleware + auth loading + Effect runtime setup.
+app.use('*', setupHonertia<Env, BindingsService>({
+  honertia: {
+    // Use your asset manifest hash so Inertia reloads on deploy.
+    version: assetVersion,
+    render: createTemplate((ctx) => {
+      const isProd = ctx.env.ENVIRONMENT === 'production'
+      return {
+        title: 'My Web App',
+        scripts: isProd ? [assetPath(entry.file)] : [vite.script()],
+        styles: isProd ? (entry.css ?? []).map(assetPath) : [],
+        head: isProd ? '' : vite.hmrHead(),
+      }
+    }),
+  },
+  effect: {
+    // Expose Cloudflare bindings to Effect handlers via a service layer.
+    services: (c) => Layer.succeed(BindingsService, {
+      KV: c.env.MY_KV,
+    }),
+  },
+  // Optional: extra Hono middleware in the same chain.
+  middleware: [
+    logger(),
+    // register additional middleware here...
+  ],
+}))
 
-// Effect bridge (sets up Effect runtime per request)
-app.use('*', effectBridge())
+registerRoutes(app)
+registerErrorHandlers(app)
 
-// Register routes
-effectAuthRoutes(app, {
-  loginComponent: 'Auth/Login',
-  registerComponent: 'Auth/Register',
-})
+export default app
+```
 
-effectRoutes(app)
-  .provide(RequireAuthLayer)
-  .group((route) => {
-    route.get('/', showDashboard)
-    route.get('/projects', listProjects)
-    route.post('/projects', createProject)
+```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) wired to better-auth.
+  // CORS for /api/auth/* can be enabled via the `cors` option (see below).
+  effectAuthRoutes(app, {
+    loginComponent: 'Auth/Login',
+    registerComponent: 'Auth/Register',
   })
 
-export default app
+  // Effect routes give you typed, DI-friendly handlers (no direct Hono ctx).
+  effectRoutes(app)
+    .provide(RequireAuthLayer)
+    .group((route) => {
+      // Grouped routes share layers and path prefixes.
+      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
+      })
+    })
+}
 ```
 
-### Using `setupHonertia` (Recommended)
+### Environment Variables
 
-For a cleaner setup, use `setupHonertia` which bundles all core middleware into a single call:
+Honertia reads these from `c.env` (Cloudflare Workers bindings):
 
-```typescript
-import { Hono } from 'hono'
-import { setupHonertia, createTemplate, effectRoutes } from 'honertia'
+```toml
+# wrangler.toml
+ENVIRONMENT = "production"
+```
 
-const app = new Hono()
+If you prefer `wrangler.jsonc`, the same binding looks like:
 
-app.use('*', setupHonertia({
-  honertia: {
-    version: '1.0.0',
-    render: createTemplate({
-      title: 'My App',
-      scripts: ['http://localhost:5173/src/main.tsx'],
-    }),
+```jsonc
+{
+  "vars": {
+    "ENVIRONMENT": "production"
+  }
+}
+```
+
+Set secrets like `DATABASE_URL` and `BETTER_AUTH_SECRET` via Wrangler (not in source control):
+
+```bash
+wrangler secret put DATABASE_URL
+wrangler secret put BETTER_AUTH_SECRET
+```
+
+### Client Setup (React + Inertia)
+
+Honertia uses the standard Inertia React client. You'll need a client entry
+point and a Vite build that emits a manifest (for `createVersion`).
+
+Install client dependencies:
+
+```bash
+bun add react react-dom @inertiajs/react
+bun add -d @vitejs/plugin-react tailwindcss @tailwindcss/vite
+```
+
+Create a Vite config that enables Tailwind v4, sets up an alias used in the
+examples, and emits `dist/manifest.json`:
+
+```typescript
+// vite.config.ts
+import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+import tailwindcss from '@tailwindcss/vite'
+import path from 'path'
+
+export default defineConfig({
+  plugins: [tailwindcss(), react()],
+  build: {
+    outDir: 'dist',
+    // Use an explicit filename so imports match build output.
+    manifest: 'manifest.json',
+    emptyOutDir: true,
   },
-  auth: {
-    userKey: 'user',
-    sessionCookie: 'session',
+  resolve: {
+    alias: {
+      '~': path.resolve(__dirname, 'src'),
+    },
   },
-  effect: {
-    // Effect bridge configuration
+})
+```
+
+Create a Tailwind CSS entry file:
+
+```css
+/* src/styles.css */
+@import "tailwindcss";
+
+@layer base {
+  body {
+    margin: 0;
+    font-family: ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif;
+    background-color: #f8fafc;
+    color: #0f172a;
+  }
+}
+```
+
+Set up the Inertia client entry point (default path matches `vite.script()`):
+
+```tsx
+// src/main.tsx
+import './styles.css'
+
+import { createInertiaApp } from '@inertiajs/react'
+import { createRoot } from 'react-dom/client'
+
+const pages = import.meta.glob('./pages/**/*.tsx')
+
+createInertiaApp({
+  resolve: (name) => {
+    const page = pages[`./pages/${name}.tsx`]
+    if (!page) {
+      throw new Error(`Page not found: ${name}`)
+    }
+    return page()
   },
-}))
+  setup({ el, App, props }) {
+    createRoot(el).render(<App {...props} />)
+  },
+})
+```
 
-export default app
+The `resolve` function maps `render('Projects/Index')` to
+`src/pages/Projects/Index.tsx`.
+
+Optional: add a `tailwind.config.ts` only if you need theme extensions or
+custom content globs.
+
+### Build & Deploy Notes
+
+The server imports `dist/manifest.json`, so it must exist at build time. In
+production, read scripts and styles from the manifest (Tailwind's CSS is listed
+under your entry's `css` array). When deploying with Wrangler, build the client
+assets first:
+
+```bash
+# build client assets before deploying the worker
+bun run build:client
+wrangler deploy
 ```
 
-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
+Optional dev convenience: if you want to run the worker without building the
+client, you can keep a stub `dist/manifest.json` (ignored by git) and replace it
+once you run `vite build`.
 
-#### Adding Custom Middleware
+### Recommended File Structure
 
-You can inject additional middleware that runs after the core setup:
+Here's a minimal project layout that matches the Quick Start:
+
+```
+.
+├── src/
+│   ├── index.ts                 # Hono app setup (setupHonertia)
+│   ├── routes.ts                # effectRoutes / effectAuthRoutes
+│   ├── main.tsx                 # Inertia + React client entry
+│   ├── styles.css               # Tailwind CSS entry
+│   ├── actions/
+│   │   └── projects/
+│   │       └── list.ts           # listProjects action
+│   ├── pages/
+│   │   └── Projects/
+│   │       └── Index.tsx         # render('Projects/Index')
+│   ├── db.ts
+│   ├── lib/
+│   │   └── auth.ts
+│   └── types.ts
+├── dist/
+│   └── manifest.json            # generated by Vite build
+├── vite.config.ts
+├── wrangler.toml                # or wrangler.jsonc
+├── package.json
+└── tsconfig.json
+```
+
+### 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[]
+}
+
+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)),
+  })
+
+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('Projects/Index', props)
+})
+```
+
+The component name `Projects/Index` maps to a file on disk. A common
+Vite + React layout is:
+
+```
+src/pages/Projects/Index.tsx
 ```
 
-The custom middleware runs in order after `effectBridge`, giving you access to all Honertia context variables.
+That means the folders mirror the component path, and `Index.tsx` is the file
+that exports the page component. In the example below, `Link` comes from
+`@inertiajs/react` because it performs Inertia client-side visits (preserving
+page state and avoiding full reloads), whereas a plain `<a>` would do a full
+navigation.
+
+```tsx
+// src/pages/Projects/Index.tsx
+/**
+ * Projects Index Page
+ */
+
+import { Link } from '@inertiajs/react'
+import Layout from '~/components/Layout'
+import type { PageProps, Project } from '~/types'
+
+interface Props {
+  projects: Project[]
+}
+
+export default function ProjectsIndex({ projects }: PageProps<Props>) {
+  return (
+    <Layout>
+      <div className="flex justify-between items-center mb-6">
+        <h1 className="text-2xl font-bold text-gray-900">Projects</h1>
+        <Link
+          href="/projects/create"
+          className="bg-indigo-600 text-white px-4 py-2 rounded-md hover:bg-indigo-700"
+        >
+          New Project
+        </Link>
+      </div>
+      
+      <div className="bg-white rounded-lg shadow">
+        {projects.length === 0 ? (
+          <div className="p-6 text-center text-gray-500">
+            No projects yet.{' '}
+            <Link href="/projects/create" className="text-indigo-600 hover:underline">
+              Create your first project
+            </Link>
+          </div>
+        ) : (
+          <ul className="divide-y divide-gray-200">
+            {projects.map((project) => (
+              <li key={project.id}>
+                <Link
+                  href={`/projects/${project.id}`}
+                  className="block px-6 py-4 hover:bg-gray-50"
+                >
+                  <div className="flex justify-between items-start">
+                    <div>
+                      <h3 className="text-sm font-medium text-gray-900">
+                        {project.name}
+                      </h3>
+                      {project.description && (
+                        <p className="text-sm text-gray-500 mt-1">
+                          {project.description}
+                        </p>
+                      )}
+                    </div>
+                    <span className="text-sm text-gray-400">
+                      {new Date(project.createdAt).toLocaleDateString()}
+                    </span>
+                  </div>
+                </Link>
+              </li>
+            ))}
+          </ul>
+        )}
+      </div>
+    </Layout>
+  )
+}
+```
 
-#### Environment-Aware Templates
+### 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'
+
+vite.script()   // 'http://localhost:5173/src/main.tsx'
+vite.hmrHead()  // HMR preamble script tags for React Fast Refresh
 ```
 
-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
+## Requirements
+
+- **Runtime**: Node.js 18+ or Bun 1.0+
+- **Peer Dependencies**:
+  - `hono` >= 4.0.0
+  - `better-auth` >= 1.0.0
+- **Dependencies**:
+  - `effect` >= 3.12.0
 
 ## Core Concepts
 
@@ -237,6 +483,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:
@@ -487,6 +818,23 @@ effectAuthRoutes(app, {
 })
 ```
 
+To enable CORS for the auth API handler (`/api/auth/*`), pass a `cors` config.
+By default, no CORS headers are added (recommended when your UI and API share the same origin).
+Use this when your frontend is on a different origin (local dev, separate domain, mobile app, etc.).
+
+```typescript
+effectAuthRoutes(app, {
+  apiPath: '/api/auth',
+  cors: {
+    origin: ['http://localhost:5173', 'http://localhost:3000'],
+    credentials: true,
+  },
+})
+```
+
+This sets the appropriate `Access-Control-*` headers and handles `OPTIONS` preflight for the auth API routes.
+Always keep the `origin` list tight; avoid `'*'` for auth endpoints, especially with `credentials: true`.
+
 ## Action Factories
 
 For common patterns, use action factories:

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/helpers.d.ts

@@ -6,6 +6,12 @@ import type { PageObject } from './types.js';
 export interface PageProps {
     errors?: Record<string, string>;
 }
+export interface AssetManifestEntry {
+    file?: string;
+    css?: string[];
+    assets?: string[];
+}
+export type AssetManifest = Record<string, string | AssetManifestEntry>;
 export interface TemplateOptions {
     title?: string;
     scripts?: string[];
@@ -26,16 +32,23 @@ export interface TemplateOptions {
  *
  * @example Dynamic config based on environment
  * ```ts
+ * const entry = manifest['src/main.tsx']
+ * const assetPath = (path: string) => `/${path}`
+ *
  * createTemplate((ctx) => ({
  *   title: 'App',
  *   scripts: ctx.env.ENVIRONMENT === 'production'
- *     ? ['/assets/main.js']
- *     : ['http://localhost:5173/src/main.tsx'],
+ *     ? [assetPath(entry.file)]
+ *     : [vite.script()],
+ *   styles: ctx.env.ENVIRONMENT === 'production'
+ *     ? (entry.css ?? []).map(assetPath)
+ *     : [],
+ *   head: ctx.env.ENVIRONMENT === 'production' ? '' : vite.hmrHead(),
  * }))
  * ```
  */
 export declare function createTemplate(options: TemplateOptions | ((ctx: Context) => TemplateOptions)): (page: PageObject, ctx?: Context) => string;
-export declare function createVersion(manifest: Record<string, string>): string;
+export declare function createVersion(manifest: AssetManifest): string;
 /**
  * Vite development configuration helpers.
  */
@@ -57,7 +70,7 @@ export declare const vite: {
      * @param port - Vite dev server port (default: 5173)
      * @example
      * ```ts
-     * scripts: isProd ? ['/assets/main.js'] : [vite.script()]
+     * scripts: isProd ? [manifest['src/main.tsx'].file] : [vite.script()]
      * ```
      */
     script(entry?: string, port?: number): string;

package/dist/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AACnC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,eAAe,GAAG,CAAC,CAAC,GAAG,EAAE,OAAO,KAAK,eAAe,CAAC,GAC7D,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,EAAE,OAAO,KAAK,MAAM,CA6C7C;AAWD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAStE;AAED;;GAEG;AACH,eAAO,MAAM,IAAI;IACf;;;;;;;;OAQG;4BACmB,MAAM;IAa5B;;;;;;;;;OASG;2CAC2C,MAAM;CAGrD,CAAA"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AACnC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAChC;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,EAAE,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAAC,CAAA;AAEvE,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,eAAe,GAAG,CAAC,CAAC,GAAG,EAAE,OAAO,KAAK,eAAe,CAAC,GAC7D,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,EAAE,OAAO,KAAK,MAAM,CA6C7C;AAWD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CA8B7D;AAED;;GAEG;AACH,eAAO,MAAM,IAAI;IACf;;;;;;;;OAQG;4BACmB,MAAM;IAa5B;;;;;;;;;OASG;2CAC2C,MAAM;CAGrD,CAAA"}

package/dist/helpers.js

@@ -14,11 +14,18 @@
  *
  * @example Dynamic config based on environment
  * ```ts
+ * const entry = manifest['src/main.tsx']
+ * const assetPath = (path: string) => `/${path}`
+ *
  * createTemplate((ctx) => ({
  *   title: 'App',
  *   scripts: ctx.env.ENVIRONMENT === 'production'
- *     ? ['/assets/main.js']
- *     : ['http://localhost:5173/src/main.tsx'],
+ *     ? [assetPath(entry.file)]
+ *     : [vite.script()],
+ *   styles: ctx.env.ENVIRONMENT === 'production'
+ *     ? (entry.css ?? []).map(assetPath)
+ *     : [],
+ *   head: ctx.env.ENVIRONMENT === 'production' ? '' : vite.hmrHead(),
  * }))
  * ```
  */
@@ -66,7 +73,26 @@ function escapeHtml(str) {
         .replace(/'/g, ''');
 }
 export function createVersion(manifest) {
-    const combined = Object.values(manifest).sort().join('');
+    const assetFiles = [];
+    for (const value of Object.values(manifest)) {
+        if (typeof value === 'string') {
+            assetFiles.push(value);
+            continue;
+        }
+        if (!value || typeof value !== 'object') {
+            continue;
+        }
+        if (typeof value.file === 'string') {
+            assetFiles.push(value.file);
+        }
+        if (Array.isArray(value.css)) {
+            assetFiles.push(...value.css);
+        }
+        if (Array.isArray(value.assets)) {
+            assetFiles.push(...value.assets);
+        }
+    }
+    const combined = assetFiles.sort().join('');
     let hash = 0;
     for (let i = 0; i < combined.length; i++) {
         const char = combined.charCodeAt(i);
@@ -107,7 +133,7 @@ export const vite = {
      * @param port - Vite dev server port (default: 5173)
      * @example
      * ```ts
-     * scripts: isProd ? ['/assets/main.js'] : [vite.script()]
+     * scripts: isProd ? [manifest['src/main.tsx'].file] : [vite.script()]
      * ```
      */
     script(entry = '/src/main.tsx', port = 5173) {

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.2",
   "description": "Inertia.js-style server-driven SPA adapter for Hono",
   "type": "module",
   "main": "./dist/index.js",