style(docs): expand code examples to multi-line literals

- Normalize description quoting and table padding in touched files
- Reformat single-line object and call literals to multi-line

Author: NeaByteLab

docs/by-design/bearer-auth.md

@@ -102,7 +102,16 @@ const bearer = WrapMware('Bearer', async (ctx: Context, next) => {
 
 // Apply the guard and error shape
 router.use(bearer)
-router.catch((ctx, err) => ctx.send.json({ error: err.error?.message }, { status: 401 }))
+router.catch((ctx, err) => {
+  return ctx.send.json(
+    {
+      error: err.error?.message
+    },
+    {
+      status: 401
+    }
+  )
+})
 ```
 
 This is the same wrapping pattern [Basic Auth](/middleware/basic-auth) uses internally, now carrying a token check instead of a credential compare.

docs/by-design/cache.md

@@ -34,13 +34,19 @@ export async function GET(ctx: Context): Promise<Response> {
   // Serve the cached value when present
   const hit = cache.get(key)
   if (hit !== undefined) {
-    return ctx.send.json({ source: 'cache', data: hit })
+    return ctx.send.json({
+      source: 'cache',
+      data: hit
+    })
   }
 
   // Build it once, then store for next time
   const data = await buildExpensiveData()
   cache.set(key, data)
-  return ctx.send.json({ source: 'fresh', data })
+  return ctx.send.json({
+    source: 'fresh',
+    data
+  })
 }
 
 declare function buildExpensiveData(): Promise<unknown>
@@ -63,13 +69,22 @@ export function GET(ctx: Context): Response {
 
   // Fresh entry wins, expired one is dropped
   if (entry && Date.now() < entry.expiresAt) {
-    return ctx.send.json({ source: 'cache', data: entry.value })
+    return ctx.send.json({
+      source: 'cache',
+      data: entry.value
+    })
   }
 
   // Recompute and stamp a new expiry
   const value = { time: Date.now() }
-  cache.set(key, { value, expiresAt: Date.now() + ttlMs })
-  return ctx.send.json({ source: 'fresh', data: value })
+  cache.set(key, {
+    value,
+    expiresAt: Date.now() + ttlMs
+  })
+  return ctx.send.json({
+    source: 'fresh',
+    data: value
+  })
 }
 ```
 

docs/by-design/compress.md

@@ -42,7 +42,9 @@ import type { Context } from '@neabyte/deserve'
 // ---cut---
 export function GET(ctx: Context): Response {
   // Send plain, runtime compresses when able
-  return ctx.send.json({ message: 'compressed by the runtime' })
+  return ctx.send.json({
+    message: 'compressed by the runtime'
+  })
 }
 ```
 
@@ -56,7 +58,9 @@ import type { Context } from '@neabyte/deserve'
 export function GET(ctx: Context): Response {
   // Block any layer from rewriting the body
   ctx.setHeader('Cache-Control', 'no-transform')
-  return ctx.send.json({ message: 'sent verbatim' })
+  return ctx.send.json({
+    message: 'sent verbatim'
+  })
 }
 ```
 

docs/by-design/https-redirect.md

@@ -46,7 +46,9 @@ import type { Context } from '@neabyte/deserve'
 export function GET(ctx: Context): Response {
   // Scheme the client actually used
   const proto = ctx.header('x-forwarded-proto') ?? 'http'
-  return ctx.send.json({ secure: proto === 'https' })
+  return ctx.send.json({
+    secure: proto === 'https'
+  })
 }
 ```
 

docs/by-design/method-override.md

@@ -29,26 +29,42 @@ import type { Context } from '@neabyte/deserve'
 // ---cut---
 // Read one item by id
 export function GET(ctx: Context): Response {
-  return ctx.send.json({ id: ctx.param('id') })
+  return ctx.send.json({
+    id: ctx.param('id')
+  })
 }
 
 // Replace the item
 export function PUT(ctx: Context): Response {
-  return ctx.send.json({ updated: true })
+  return ctx.send.json({
+    updated: true
+  })
 }
 
 // Remove the item
 export function DELETE(ctx: Context): Response {
-  return ctx.send.json({ deleted: true })
+  return ctx.send.json({
+    deleted: true
+  })
 }
 ```
 
 The client targets each one by sending the matching method. See [file-based routing](/core-concepts/file-based-routing) for how a file maps to a route.
 
 ```typescript twoslash
 // Each call hits its own handler
-await fetch('/items/42', { method: 'PUT' })
-await fetch('/items/42', { method: 'DELETE' })
+await fetch(
+  '/items/42',
+  {
+    method: 'PUT'
+  }
+)
+await fetch(
+  '/items/42',
+  {
+    method: 'DELETE'
+  }
+)
 ```
 
 Building stateless or stateful is the same move, just drop the files. A stateless REST endpoint is a handler that reads the request and replies, while a stateful flow adds the [session middleware](/middleware/session) and reads per-user data from [`ctx.state`](/core-concepts/context-object#sharing-state). The method stays real either way, with nothing to disguise on the way in.

docs/by-design/pretty-json.md

@@ -21,7 +21,10 @@ import type { Context } from '@neabyte/deserve'
 // ---cut---
 export function GET(ctx: Context): Response {
   // Compact body, no extra whitespace
-  return ctx.send.json({ id: 1, name: 'Alice' })
+  return ctx.send.json({
+    id: 1,
+    name: 'Alice'
+  })
 }
 ```
 
@@ -36,11 +39,20 @@ import type { Context } from '@neabyte/deserve'
 // ---cut---
 export function GET(ctx: Context): Response {
   // Indent on purpose for this route
-  const body = JSON.stringify({ id: 1, name: 'Alice' }, null, 2)
+  const body = JSON.stringify(
+    {
+      id: 1,
+      name: 'Alice'
+    },
+    null,
+    2
+  )
 
   // Send as text, keep JSON type
   return ctx.send.text(body, {
-    headers: { 'Content-Type': 'application/json' }
+    headers: {
+      'Content-Type': 'application/json'
+    }
   })
 }
 ```

docs/by-design/rate-limit.md

@@ -46,7 +46,10 @@ router.use(async (ctx, next) => {
 
   // Fresh window when missing or expired
   if (!entry || now > entry.resetAt) {
-    hits.set(key, { count: 1, resetAt: now + windowMs })
+    hits.set(key, {
+      count: 1,
+      resetAt: now + windowMs
+    })
     return await next()
   }
 
@@ -57,7 +60,12 @@ router.use(async (ctx, next) => {
   if (entry.count > maxRequests) {
     const retryAfter = Math.ceil((entry.resetAt - now) / 1000)
     ctx.setHeader('Retry-After', String(retryAfter))
-    return ctx.send.text('Too Many Requests', { status: 429 })
+    return ctx.send.text(
+      'Too Many Requests',
+      {
+        status: 429
+      }
+    )
   }
 
   // Still under the cap, continue
@@ -89,7 +97,10 @@ router.use(async (ctx, next) => {
 
   // Start a fresh window when needed
   if (!entry || now > entry.resetAt) {
-    entry = { count: 0, resetAt: now + windowMs }
+    entry = {
+      count: 0,
+      resetAt: now + windowMs
+    }
     hits.set(key, entry)
   }
 
@@ -105,7 +116,14 @@ router.use(async (ctx, next) => {
 
   // Block once the cap is passed
   if (entry.count > maxRequests) {
-    return ctx.send.json({ error: 'Too Many Requests' }, { status: 429 })
+    return ctx.send.json(
+      {
+        error: 'Too Many Requests'
+      },
+      {
+        status: 429
+      }
+    )
   }
 
   return await next()
@@ -127,7 +145,14 @@ declare function isOverLimit(key: string): boolean
 router.use('/auth', async (ctx, next) => {
   const key = ctx.ip ?? 'unknown'
   if (isOverLimit(key)) {
-    return ctx.send.json({ error: 'Slow down' }, { status: 429 })
+    return ctx.send.json(
+      {
+        error: 'Slow down'
+      },
+      {
+        status: 429
+      }
+    )
   }
   return await next()
 })

docs/by-design/request-id.md

@@ -33,7 +33,9 @@ For correlating logs, the [lifecycle events](/middleware/observability/overview)
 ```typescript twoslash
 import { Router } from '@neabyte/deserve'
 
-const router = new Router({ routesDir: './routes' })
+const router = new Router({
+  routesDir: './routes'
+})
 // ---cut---
 router.on((event) => {
   // Correlate by real IP and time

docs/by-design/server-timing.md

@@ -19,7 +19,9 @@ Every `request:complete` event carries `durationMs`, the measured time for the w
 ```typescript twoslash
 import { Router } from '@neabyte/deserve'
 
-const router = new Router({ routesDir: './routes' })
+const router = new Router({
+  routesDir: './routes'
+})
 // ---cut---
 router.on((event) => {
   // Read the measured request duration

docs/by-design/tracing.md

@@ -41,7 +41,9 @@ This listener turns each finished request into a span-shaped record and hands it
 ```typescript twoslash
 import { Router } from '@neabyte/deserve'
 
-const router = new Router({ routesDir: './routes' })
+const router = new Router({
+  routesDir: './routes'
+})
 declare function exportSpan(span: Record<string, unknown>): void
 // ---cut---
 router.on((event) => {