add createFactory() and createHandlers()

guides/best-practices.md

@@ -38,6 +38,31 @@ app.get('/books/:id', (c) => {
 })
 ```
 
+## `factory.createHandlers()` in `hono/factory`
+
+If you still want to create a RoR-like Controller, use `factory.createHandlers()` in [`hono/factory`](/helpers/factory). If you use this, type inference will work correctly.
+
+```ts
+import { createFactory } from 'hono/factory'
+import { logger } from 'hono/logger'
+
+// ...
+
+// 😃
+const factory = createFactory()
+
+const middleware = factory.createMiddleware(async (c, next) => {
+  c.set('foo', 'bar')
+  await next()
+})
+
+const handlers = factory.createHandlers(logger(), middleware, (c) => {
+  return c.json(c.var.foo)
+})
+
+app.get('/api', ...handlers)
+```
+
 ## Building a larger application
 
 Use `app.route()` to build a larger application without creating "Ruby on Rails-like Controllers".

helpers/factory.md

@@ -8,18 +8,41 @@ The Factory Helper provides useful functions for creating Hono's components such
 
 ```ts [npm]
 import { Hono } from 'hono'
-import { createMiddleware } from 'hono/factory'
+import { createFactory, createMiddleware } from 'hono/factory'
 ```
 
 ```ts [Deno]
 import { Hono } from 'https://deno.land/x/hono/mod.ts'
-import { createMiddleware } from 'https://deno.land/x/hono/helper.ts'
+import { createFactory, createMiddleware } from 'https://deno.land/x/hono/helper.ts'
 ```
 
 :::
 
+## `createFactory()`
+
+`createFactory()` will create an instance of Factory class.
+
+```ts
+import { createFactory } from 'hono/factory'
+
+const factory = createFactory()
+```
+
+You can pass your Env types as Generics:
+
+```ts
+type Env = {
+  Variables: {
+    foo: string
+  }
+}
+
+const factory = createFactory<Env>()
+```
+
 ## `createMiddleware()`
 
+`createMiddleware()` is shortcut of `factory.createMiddleware()`.
 This function will create your custom middleware.
 
 ```ts
@@ -41,3 +64,27 @@ const messageMiddleware = (message: string) => {
 
 app.use('*', messageMiddleware('Good evening!'))
 ```
+
+## `factory.createHandlers()` <Badge style="vertical-align: middle;" type="warning" text="Experimental" />
+
+This function helps to define handlers in a different place than `app.get('/')`.
+
+```ts
+import { createFactory } from 'hono/factory'
+import { logger } from 'hono/logger'
+
+// ...
+
+const factory = createFactory()
+
+const middleware = factory.createMiddleware(async (c, next) => {
+  c.set('foo', 'bar')
+  await next()
+})
+
+const handlers = factory.createHandlers(logger(), middleware, (c) => {
+  return c.json(c.var.foo)
+})
+
+app.get('/api', ...handlers)
+```