From a461d371dfec255af572a6e8d4a1988261f603ae Mon Sep 17 00:00:00 2001
From: Thijs Schreijer <thijs@thijsschreijer.nl>
Date: Wed, 4 Mar 2026 10:16:27 +0100
Subject: [PATCH 1/3] feat(request): add a query method

It was a field on the object, this adds a 'getter', similar
to the method, path, etc.
---
 example/querystring.lua    |  2 +-
 spec/unit/request_spec.lua |  2 +-
 src/pegasus/request.lua    | 10 +++++++++-
 3 files changed, 11 insertions(+), 3 deletions(-)

diff --git a/example/querystring.lua b/example/querystring.lua
index 84ddb59..2d8ba04 100644
--- a/example/querystring.lua
+++ b/example/querystring.lua
@@ -14,7 +14,7 @@ local printTable = function(table)
 end
 
 server:start(function (req, res)
-  printTable(req['querystring'])
+  printTable(req:query())
   res:addHeader('Content-Type', 'text/html'):write('hello pegasus world!')
 
   -- return a truthy value to indicate the request was handled, no further handling needed
diff --git a/spec/unit/request_spec.lua b/spec/unit/request_spec.lua
index f2841e0..711d4d5 100644
--- a/spec/unit/request_spec.lua
+++ b/spec/unit/request_spec.lua
@@ -75,7 +75,7 @@ describe('require', function()
     )
 
     assert.are.same(
-      request.querystring, {
+      request:query(), {
         a = 'b',
         c = 'd',
         e = { '1', '2' },
diff --git a/src/pegasus/request.lua b/src/pegasus/request.lua
index c6579e2..111388c 100644
--- a/src/pegasus/request.lua
+++ b/src/pegasus/request.lua
@@ -215,7 +215,15 @@ function Request:method()
   return self._method
 end
 
---- Read and parse headers.
+--- Query-string parameters.
+-- Returns a hash table. Duplicate keys are represented as an array of values.
+-- @treturn table querystring
+function Request:query()
+  self:parseFirstLine()
+  return self.querystring
+end
+
+--- Request headers.
 -- Returns a case-insensitive table: looking up with any casing works.
 -- If a header appears multiple times, the value becomes a table of strings.
 -- @treturn table headers

From c47eb60d52cd822ac80d345d7f0621a86d16b5e4 Mon Sep 17 00:00:00 2001
From: Thijs Schreijer <thijs@thijsschreijer.nl>
Date: Sun, 29 Mar 2026 15:19:18 +0200
Subject: [PATCH 2/3] chore(docs): create ldoc based documentation

---
 config.ld                         |  16 +
 doc_topics/ldoc.css               | 618 ++++++++++++++++++++++++++++++
 src/pegasus/handler.lua           |  91 ++---
 src/pegasus/init.lua              |  84 ++--
 src/pegasus/log.lua               |   6 +-
 src/pegasus/plugins/compress.lua  |  24 +-
 src/pegasus/plugins/downloads.lua |  39 +-
 src/pegasus/plugins/files.lua     |  27 +-
 src/pegasus/plugins/router.lua    | 147 ++++---
 src/pegasus/plugins/tls.lua       |  18 +-
 src/pegasus/request.lua           |  93 ++---
 src/pegasus/response.lua          | 149 +++----
 12 files changed, 881 insertions(+), 431 deletions(-)
 create mode 100644 config.ld
 create mode 100644 doc_topics/ldoc.css

diff --git a/config.ld b/config.ld
new file mode 100644
index 0000000..d903da2
--- /dev/null
+++ b/config.ld
@@ -0,0 +1,16 @@
+project='Pegasus'
+title='Pegasus webserver in Lua'
+description='Minimal, embeddable HTTP server with a simple plugin system.'
+
+format='markdown'
+use_markdown_titles = true
+style="./doc_topics/"
+
+file={'./src/'}
+topics={'./LICENSE', './README.md'}
+examples = {'./example'}
+
+dir='docs'
+sort=true
+sort_modules=true
+all=false
diff --git a/doc_topics/ldoc.css b/doc_topics/ldoc.css
new file mode 100644
index 0000000..df2c98f
--- /dev/null
+++ b/doc_topics/ldoc.css
@@ -0,0 +1,618 @@
+/* Pegasus LDoc — modern documentation theme (CSS only) */
+:root {
+    --bg-page: #f4f6f9;
+    --bg-surface: #ffffff;
+    --bg-sidebar: #fafbfc;
+    --border: #e2e8f0;
+    --border-strong: #cbd5e1;
+    --text: #1e293b;
+    --text-muted: #64748b;
+    --accent: #2563eb;
+    --accent-hover: #1d4ed8;
+    --accent-soft: rgba(37, 99, 235, 0.08);
+    --accent-ring: rgba(37, 99, 235, 0.35);
+    --header-ink: #0f172a;
+    --radius: 10px;
+    --radius-sm: 6px;
+    --shadow: 0 1px 3px rgba(15, 23, 42, 0.06);
+    --shadow-md: 0 4px 24px rgba(15, 23, 42, 0.08);
+    --font-sans: ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto,
+        "Helvetica Neue", Arial, sans-serif;
+    --font-mono: ui-monospace, "SF Mono", "Cascadia Code", "Source Code Pro",
+        Menlo, Consolas, monospace;
+}
+
+*,
+*::before,
+*::after {
+    box-sizing: border-box;
+}
+
+html {
+    scroll-behavior: smooth;
+}
+
+body {
+    margin: 0;
+    color: var(--text);
+    font-size: 16px;
+    line-height: 1.6;
+    font-family: var(--font-sans);
+    background: var(--bg-page);
+    -webkit-font-smoothing: antialiased;
+}
+
+#product {
+    display: none;
+}
+
+#container {
+    min-height: 100vh;
+    display: flex;
+    flex-direction: column;
+}
+
+#main {
+    display: flex;
+    flex: 1;
+    align-items: flex-start;
+    width: 100%;
+}
+
+a:link,
+a:visited {
+    color: var(--accent);
+    text-decoration-skip-ink: auto;
+}
+
+a:hover {
+    color: var(--accent-hover);
+    text-decoration: underline;
+    text-underline-offset: 2px;
+}
+
+h1 {
+    font-size: 1.75rem;
+    font-weight: 650;
+    letter-spacing: -0.02em;
+    color: var(--header-ink);
+}
+
+h2 {
+    font-size: 1.35rem;
+    font-weight: 600;
+    letter-spacing: -0.015em;
+    color: var(--header-ink);
+}
+
+h3 {
+    font-size: 1.125rem;
+    font-weight: 600;
+    color: var(--header-ink);
+}
+
+h4 {
+    font-size: 1rem;
+    font-weight: 600;
+    color: var(--header-ink);
+}
+
+hr {
+    height: 1px;
+    background: var(--border);
+    border: 0;
+    margin: 1.25rem 0;
+}
+
+code,
+tt {
+    font-family: var(--font-mono);
+    font-size: 0.9em;
+    background: var(--accent-soft);
+    color: var(--header-ink);
+    padding: 0.15em 0.4em;
+    border-radius: 4px;
+}
+
+#content h1 code {
+    background: rgba(255, 255, 255, 0.15);
+    color: inherit;
+    padding: 0.1em 0.35em;
+}
+
+span.parameter {
+    font-family: var(--font-mono);
+    font-weight: 600;
+    color: var(--text-muted);
+}
+
+span.parameter::after {
+    content: ":";
+}
+
+span.types::before {
+    content: "(";
+}
+
+span.types::after {
+    content: ")";
+}
+
+.type {
+    font-weight: 600;
+    font-style: italic;
+    color: var(--text-muted);
+}
+
+p.name {
+    font-family: var(--font-mono);
+    font-size: 0.95em;
+}
+
+#navigation {
+    float: none;
+    flex: 0 0 min(17rem, 42vw);
+    max-width: 17rem;
+    vertical-align: top;
+    overflow: visible;
+    background:
+        linear-gradient(180deg, rgba(37, 99, 235, 0.06), rgba(37, 99, 235, 0))
+            0 0 / 100% 240px no-repeat,
+        var(--bg-sidebar);
+    border-right: 1px solid var(--border);
+    box-shadow: var(--shadow);
+    position: sticky;
+    top: 0;
+    align-self: stretch;
+    max-height: 100vh;
+    overflow-y: auto;
+}
+
+#navigation br {
+    display: none;
+}
+
+#navigation h1 {
+    margin: 0;
+    padding: 1.25rem 1.25rem 1rem;
+    font-size: 1.1rem;
+    font-weight: 700;
+    letter-spacing: -0.02em;
+    color: var(--header-ink);
+    background: transparent;
+    border-bottom: 1px solid var(--border);
+}
+
+#navigation h2 {
+    font-size: 0.7rem;
+    font-weight: 700;
+    text-transform: uppercase;
+    letter-spacing: 0.08em;
+    color: var(--text-muted);
+    background: transparent;
+    border-bottom: none;
+    padding: 1.25rem 1.25rem 0.5rem;
+    margin: 0;
+}
+
+#navigation ul + h2 {
+    border-top: 1px dashed var(--border);
+    margin-top: 0.25rem;
+}
+
+#content {
+    float: none;
+    margin-left: 0;
+    flex: 1;
+    min-width: 0;
+    background: var(--bg-surface);
+    border-radius: 0;
+    box-shadow: var(--shadow-md);
+}
+
+#content h1 {
+    margin: 0;
+    padding: 1.35rem 1.5rem;
+    background: linear-gradient(135deg, #1e3a5f 0%, #0f172a 100%);
+    color: #f8fafc;
+    font-weight: 650;
+    letter-spacing: -0.02em;
+    border-bottom: 1px solid rgba(255, 255, 255, 0.06);
+}
+
+#content h2 {
+    margin: 0;
+    padding: 0.85rem 1.5rem;
+    background: var(--bg-page);
+    color: var(--header-ink);
+    font-weight: 600;
+    font-size: 1.15rem;
+    border-bottom: 1px solid var(--border);
+    border-top: 1px solid var(--border);
+}
+
+#content h2:first-of-type {
+    border-top: none;
+}
+
+#content h2 a {
+    background: transparent;
+    color: inherit;
+    text-decoration: none;
+}
+
+#content h2 a:hover {
+    color: var(--accent);
+    text-decoration: none;
+}
+
+#content h3 {
+    font-style: normal;
+    margin: 1.5rem 1.5rem 0.5rem;
+    padding: 0 0 0.5rem;
+    border-bottom: 2px solid var(--border);
+    color: var(--header-ink);
+}
+
+#content h4 {
+    margin: 1.25rem 1.5rem 0.35rem;
+    padding: 0 0 0.35rem;
+    border-bottom: 1px solid var(--border);
+}
+
+#content pre {
+    margin: 1rem 1.5rem;
+}
+
+pre code {
+    background: transparent;
+    padding: 0;
+    color: inherit;
+    font-size: inherit;
+    border-radius: 0;
+}
+
+pre {
+    background: #1a1d26;
+    color: #e2e8f0;
+    border-radius: var(--radius);
+    padding: 1rem 1.15rem;
+    overflow: auto;
+    font-family: var(--font-mono);
+    font-size: 0.875rem;
+    line-height: 1.55;
+    border: 1px solid rgba(255, 255, 255, 0.06);
+    box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.04);
+}
+
+#content ul pre.example {
+    margin-left: 0;
+}
+
+table.index {
+    width: 100%;
+}
+
+table.index td {
+    text-align: left;
+    vertical-align: top;
+}
+
+#navigation ul {
+    font-size: 0.9375rem;
+    list-style: none;
+    margin: 0 0 0.75rem;
+    padding: 0.25rem 0.75rem 0.75rem;
+}
+
+#navigation li {
+    text-indent: 0;
+    display: block;
+    margin: 0.125rem 0;
+}
+
+#navigation li a {
+    position: relative;
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+    padding: 0.4rem 0.7rem;
+    border-radius: 10px;
+    color: var(--text);
+    text-decoration: none;
+    border: 1px solid transparent;
+    transition: background-color 0.15s ease, border-color 0.15s ease,
+        transform 0.05s ease;
+}
+
+#navigation li a:hover {
+    text-decoration: none;
+    background: var(--accent-soft);
+    border-color: rgba(37, 99, 235, 0.18);
+    transform: translateY(-1px);
+}
+
+#navigation li a:focus-visible {
+    outline: none;
+    box-shadow: 0 0 0 3px var(--accent-ring);
+}
+
+#navigation li li a {
+    margin: 0;
+}
+
+/* Current page: LDoc renders it as <strong> inside the list */
+#navigation li strong {
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+    padding: 0.4rem 0.7rem;
+    border-radius: 10px;
+    border: 1px solid transparent;
+    background: rgba(37, 99, 235, 0.08);
+    color: var(--accent-hover);
+    font-weight: 700;
+    box-shadow: inset 3px 0 0 rgba(37, 99, 235, 0.55);
+}
+
+#content p {
+    padding-left: 1.5rem;
+    padding-right: 1.5rem;
+}
+
+#content table {
+    padding-left: 1.5rem;
+    padding-right: 1.5rem;
+    background: transparent;
+}
+
+#content p,
+#content table,
+#content ol,
+#content ul,
+#content dl {
+    max-width: 52rem;
+}
+
+#about {
+    padding: 1rem 1.5rem;
+    padding-left: 1.5rem;
+    background: var(--bg-surface);
+    border-top: 1px solid var(--border);
+    color: var(--text-muted);
+    font-size: 0.875rem;
+}
+
+#about a {
+    color: var(--accent);
+}
+
+table.module_list,
+table.function_list {
+    border-collapse: separate;
+    border-spacing: 0;
+    margin: 1rem 1.5rem;
+    width: calc(100% - 3rem);
+    max-width: 52rem;
+    border: 1px solid var(--border);
+    border-radius: var(--radius);
+    overflow: hidden;
+    box-shadow: var(--shadow);
+}
+
+table.module_list tr:nth-child(even) td,
+table.function_list tr:nth-child(even) td {
+    background: #f8fafc;
+}
+
+table.module_list td,
+table.function_list td {
+    padding: 0.65rem 1rem;
+    border: none;
+    border-bottom: 1px solid var(--border);
+    vertical-align: top;
+}
+
+table.module_list tr:last-child td,
+table.function_list tr:last-child td {
+    border-bottom: none;
+}
+
+table.module_list td.name,
+table.function_list td.name {
+    background: transparent;
+    min-width: 200px;
+    border-right: 1px solid var(--border);
+    font-family: var(--font-mono);
+    font-size: 0.9em;
+}
+
+table.module_list td.summary,
+table.function_list td.summary {
+    background: transparent;
+    width: 100%;
+    color: var(--text-muted);
+}
+
+dl.function {
+    margin: 1rem 1.5rem 1.5rem;
+    border: none;
+    border-radius: 0;
+    background: transparent;
+    box-shadow: none;
+    overflow: visible;
+}
+
+dl.function dt {
+    color: var(--accent);
+    font-family: var(--font-mono);
+    font-size: 0.9em;
+    border: 1px solid var(--border);
+    border-bottom: none;
+    border-radius: var(--radius) var(--radius) 0 0;
+    padding: 0.9rem 1.15rem;
+    background: linear-gradient(180deg, #f8fafc 0%, #fff 100%);
+    box-shadow: var(--shadow);
+    margin-top: 1rem;
+}
+
+dl.function dt:first-child {
+    margin-top: 0;
+}
+
+dl.function dd {
+    margin: 0;
+    padding: 0.75rem 1.15rem 1.25rem;
+    border: 1px solid var(--border);
+    border-top: none;
+    border-radius: 0 0 var(--radius) var(--radius);
+    background: var(--bg-surface);
+    box-shadow: var(--shadow);
+    margin-bottom: 1rem;
+}
+
+#content dl.function dd h3 {
+    margin: 1.05rem 0 0.55rem;
+    padding: 0.85rem 0 0;
+    font-size: 0.9rem;
+    font-weight: 700;
+    letter-spacing: 0.02em;
+    text-transform: uppercase;
+    color: var(--text-muted);
+    border-top: 1px solid var(--border);
+}
+
+#content dl.function dd ul,
+#content dl.function dd ol {
+    margin: 0.25rem 0 0.75rem;
+    padding: 0;
+    padding-left: 1.25rem;
+    list-style-type: none;
+}
+
+ul.nowrap {
+    overflow: auto;
+    white-space: nowrap;
+}
+
+.section-description {
+    padding-left: 1.5rem;
+    padding-right: 1.5rem;
+}
+
+ul ul,
+ol ul,
+ol ol,
+ul ol {
+    margin-top: 0;
+}
+
+a:target + * {
+    background-color: #fef9c3;
+    box-shadow: inset 3px 0 0 0 #eab308;
+    border-radius: 0 var(--radius-sm) var(--radius-sm) 0;
+    padding-left: 0.35rem;
+    margin-left: -0.35rem;
+    transition: background-color 0.2s ease;
+}
+
+/* Syntax highlighting (prettify) */
+pre .comment {
+    color: #94a3b8;
+    font-style: italic;
+}
+
+pre .constant {
+    color: #fbbf24;
+}
+
+pre .escape {
+    color: #f472b6;
+}
+
+pre .keyword {
+    color: #c084fc;
+    font-weight: 600;
+}
+
+pre .library {
+    color: #5eead4;
+}
+
+pre .marker {
+    color: #1e293b;
+    background: #fde047;
+    font-weight: 600;
+    padding: 0 0.15em;
+    border-radius: 3px;
+}
+
+pre .string {
+    color: #86efac;
+}
+
+pre .number {
+    color: #fdba74;
+}
+
+pre .operator {
+    color: #93c5fd;
+    font-weight: 600;
+}
+
+pre .preprocessor,
+pre .prepro {
+    color: #fb923c;
+}
+
+pre .global {
+    color: #e879f9;
+}
+
+pre .user-keyword {
+    color: #d8b4fe;
+}
+
+pre .prompt {
+    color: #4ade80;
+}
+
+pre .url {
+    color: #7dd3fc;
+    text-decoration: underline;
+}
+
+pre .function-name {
+    color: #7dd3fc;
+}
+
+@media (max-width: 768px) {
+    #main {
+        flex-direction: column;
+    }
+
+    #navigation {
+        position: relative;
+        max-height: none;
+        flex: none;
+        width: 100%;
+        max-width: none;
+        border-right: none;
+        border-bottom: 1px solid var(--border);
+    }
+
+    #content p,
+    #content table,
+    #content ol,
+    #content ul,
+    #content dl {
+        max-width: none;
+    }
+
+    table.module_list,
+    table.function_list {
+        width: calc(100% - 2rem);
+        margin-left: 1rem;
+        margin-right: 1rem;
+    }
+}
diff --git a/src/pegasus/handler.lua b/src/pegasus/handler.lua
index 961bb29..a00ba2d 100644
--- a/src/pegasus/handler.lua
+++ b/src/pegasus/handler.lua
@@ -1,9 +1,10 @@
---- Module `pegasus.handler`
+--- Internal handler that drives the request/response cycle.
 --
 -- Internal orchestrator that wires the server socket to request/response
 -- objects and drives the plugin pipeline.
 --
 -- Lifecycle for each connection/request:
+--
 -- 1. `pluginsNewConnection(client)` can wrap/replace or reject the client
 -- 2. Request/Response objects are created
 -- 3. `pluginsNewRequestResponse(request, response)` runs
@@ -13,40 +14,32 @@
 -- 7. If response not closed, a default 404 is written
 --
 -- Plugins may also:
+--
 -- - modify Request/Response metatables via `alterRequestResponseMetaTable`
 -- - intercept file processing via `processFile`
 -- - filter/transform streamed body via `processBodyData`
 --
 -- Minimal plugin example:
--- ```lua
--- local MyPlugin = {}
--- function MyPlugin:new()
---   return setmetatable({}, { __index = self })
--- end
--- function MyPlugin:beforeProcess(req, res)
---   res:addHeader('X-Powered-By', 'Pegasus')
--- end
--- return MyPlugin
--- ```
 --
--- @module pegasus.handler
+--     local MyPlugin = {}
+--
+--     function MyPlugin:new()
+--       return setmetatable({}, { __index = self })
+--     end
+--
+--     function MyPlugin:beforeProcess(req, res)
+--       res:addHeader('X-Powered-By', 'Pegasus')
+--     end
+--
+--     return MyPlugin
+--
+-- @classmod pegasus.handler
 
 local Request = require 'pegasus.request'
 local Response = require 'pegasus.response'
 local Files = require 'pegasus.plugins.files'
 
 --- The request/response handler and plugin runner.
---
--- Fields:
--- - `log`: logger used by the server and plugins
--- - `callback`: user callback `function(request, response)`
--- - `plugins`: array of plugin instances
---
--- @type Handler
----@class Handler
----@field log table
----@field callback fun(request: table, response: table)|nil
----@field plugins table
 local Handler = {}
 Handler.__index = Handler
 
@@ -55,16 +48,11 @@ Handler.__index = Handler
 -- When `location` is a non-empty string, automatically enables the `files`
 -- plugin to serve static files from that directory (default index `/index.html`).
 --
--- @tparam function callback user function(request, response)
+-- @tparam function callback using signature `stop_further_processing = function(request, response)`
 -- @tparam string location base directory for static files (optional)
 -- @tparam table plugins list of plugin instances (optional)
 -- @tparam table logger logger instance (optional)
 -- @treturn Handler handler
----@param callback fun(request: table, response: table)|nil
----@param location string|nil
----@param plugins table|nil
----@param logger table|nil
----@return Handler
 function Handler:new(callback, location, plugins, logger)
   local handler = {}
   handler.log = logger or require('pegasus.log')
@@ -87,7 +75,7 @@ function Handler:new(callback, location, plugins, logger)
   return result
 end
 
---- Allow plugins to alter `Request`/`Response` metatables before use.
+-- Allow plugins to alter `Request`/`Response` metatables before use.
 -- Stops early if a plugin returns a truthy value.
 function Handler:pluginsAlterRequestResponseMetatable()
   for _, plugin in ipairs(self.plugins) do
@@ -100,12 +88,10 @@ function Handler:pluginsAlterRequestResponseMetatable()
   end
 end
 
---- Run `newConnection` hook across plugins.
+-- Run `newConnection` hook across plugins.
 -- A plugin may wrap or replace the client, or return falsy to abort.
 -- @tparam table client accepted client socket
 -- @treturn table|false client or false to stop
----@param client table
----@return table|false
 function Handler:pluginsNewConnection(client)
   for _, plugin in ipairs(self.plugins) do
     if plugin.newConnection then
@@ -118,14 +104,11 @@ function Handler:pluginsNewConnection(client)
   return client
 end
 
---- Run `newRequestResponse` hook across plugins.
+-- Run `newRequestResponse` hook across plugins.
 -- Stops early if a plugin returns a truthy value.
 -- @tparam table request
 -- @tparam table response
 -- @treturn any stop value if any plugin aborts
----@param request table
----@param response table
----@return any
 function Handler:pluginsNewRequestResponse(request, response)
   for _, plugin in ipairs(self.plugins) do
     if plugin.newRequestResponse then
@@ -137,14 +120,11 @@ function Handler:pluginsNewRequestResponse(request, response)
   end
 end
 
---- Run `beforeProcess` hook across plugins.
+-- Run `beforeProcess` hook across plugins.
 -- Stops early if a plugin returns a truthy value.
 -- @tparam table request
 -- @tparam table response
 -- @treturn any stop value if any plugin aborts
----@param request table
----@param response table
----@return any
 function Handler:pluginsBeforeProcess(request, response)
   for _, plugin in ipairs(self.plugins) do
     if plugin.beforeProcess then
@@ -156,14 +136,11 @@ function Handler:pluginsBeforeProcess(request, response)
   end
 end
 
---- Run `afterProcess` hook across plugins.
+-- Run `afterProcess` hook across plugins.
 -- Stops early if a plugin returns a truthy value.
 -- @tparam table request
 -- @tparam table response
 -- @treturn any stop value if any plugin aborts
----@param request table
----@param response table
----@return any
 function Handler:pluginsAfterProcess(request, response)
   for _, plugin in ipairs(self.plugins) do
     if plugin.afterProcess then
@@ -175,16 +152,12 @@ function Handler:pluginsAfterProcess(request, response)
   end
 end
 
---- Run `processFile` hook across plugins for a given filename.
+-- Run `processFile` hook across plugins for a given filename.
 -- Stops early if a plugin returns a truthy value.
 -- @tparam table request
 -- @tparam table response
 -- @tparam string filename
 -- @treturn any stop value if any plugin aborts
----@param request table
----@param response table
----@param filename string
----@return any
 function Handler:pluginsProcessFile(request, response, filename)
   for _, plugin in ipairs(self.plugins) do
     if plugin.processFile then
@@ -197,17 +170,13 @@ function Handler:pluginsProcessFile(request, response, filename)
   end
 end
 
---- Run the body data through plugins' `processBodyData` filters.
+-- Run the body data through plugins' `processBodyData` filters.
 -- Each plugin receives `(data, stayOpen, request, response)` and returns the
 -- (possibly) transformed data. The result of one plugin is passed to the next.
 -- @tparam string data body chunk (may be empty string)
 -- @tparam boolean stayOpen whether the connection stays open (chunked)
 -- @tparam table response associated response
 -- @treturn string transformed data
----@param data string
----@param stayOpen boolean
----@param response table
----@return string
 function Handler:processBodyData(data, stayOpen, response)
   local localData = data
 
@@ -227,16 +196,10 @@ end
 
 --- Process a single client by creating `Request`/`Response` and running pipeline.
 -- If the callback does not close the response, a default 404 page is sent.
---
 -- @tparam string|number port server port
--- @tparam table client accepted client socket
--- @tparam table server listening server socket
--- @treturn[1] boolean|nil false when connection was rejected by a plugin
--- @treturn[2] nil normal completion
----@param port string|integer
----@param client table
----@param server table
----@return boolean|nil
+-- @tparam socket client accepted client socket
+-- @tparam socket server listening server socket
+-- @treturn boolean|nil `false` when connection was rejected by a plugin, `nil` on normal completion
 function Handler:processRequest(port, client, server)
   client = self:pluginsNewConnection(client)
   if not client then
diff --git a/src/pegasus/init.lua b/src/pegasus/init.lua
index a4ffe2f..140e43b 100644
--- a/src/pegasus/init.lua
+++ b/src/pegasus/init.lua
@@ -1,24 +1,23 @@
---- Module `pegasus`
+--- The Pegasus server main entry point.
 --
 -- Minimal, embeddable HTTP server with a simple plugin system.
 --
--- Basic usage:
--- ```lua
--- local Pegasus = require 'pegasus'
--- local server = Pegasus:new{ host = '127.0.0.1', port = '8080' }
--- server:start(function(request, response)
---   response:statusCode(200)
---   response:addHeader('Content-Type', 'text/plain')
---   response:write('Hello, world!')
--- end)
--- ```
---
 -- Notes:
+--
 -- - If [LuaLogging](https://keplerproject.github.io/lualogging/) is available, it will be auto-detected and used for logging.
 -- - Common plugins include `files`, `router`, `compress`, `downloads`, and `tls`.
--- - `start` runs a blocking accept loop; run in a dedicated OS thread/process if you need concurrency.
+-- - See `pegasus.handler` for the request/response lifecycle and plugin hooks.
+--
+-- Example:
 --
--- @module pegasus
+--     local Pegasus = require 'pegasus'
+--     local server = Pegasus:new{ host = '127.0.0.1', port = '8080' }
+--     server:start(function(request, response)
+--       response:statusCode(200)
+--       response:addHeader('Content-Type', 'text/plain')
+--       response:write('Hello, world!')
+--     end)
+-- @classmod pegasus
 
 local socket = require 'socket'
 local Handler = require 'pegasus.handler'
@@ -28,46 +27,18 @@ pcall(require, 'logging')
 
 --- The Pegasus HTTP server class.
 -- Instances are created via `Pegasus:new(params)`.
---
--- Fields (defaults in parentheses):
--- - `host` ("*") bind address, e.g. "127.0.0.1" or "::".
--- - `port` ("9090") bind port.
--- - `location` ("") base directory for static files/plugins that use the filesystem.
--- - `plugins` ({}) array/table of plugin callables or plugin configurations.
--- - `timeout` (1) client socket timeout (seconds, blocking operations).
--- - `log` (auto) logger compatible with `pegasus.log` API. Defaults to `require('pegasus.log')` and integrates with LuaLogging when present.
---
--- @type Pegasus
--- @tfield string host
--- @tfield string|number port
--- @tfield string location
--- @tfield table plugins
--- @tfield number timeout
--- @tfield table log
----@class Pegasus
----@field host string
----@field port string|integer
----@field location string
----@field plugins table
----@field timeout number
----@field log table
 local Pegasus = {}
 Pegasus.__index = Pegasus
 
 --- Create a new Pegasus server instance.
---
--- Parameters table accepts:
--- - `host`: bind address (default "*").
--- - `port`: bind port (default "9090").
--- - `location`: base directory used by some plugins (default "").
--- - `plugins`: list/table of plugins to be applied (default {}).
--- - `timeout`: client socket timeout in seconds (default 1).
--- - `log`: logger instance; if omitted, `pegasus.log` is used (integrates with LuaLogging when available).
---
 -- @tparam[opt] table params configuration table
--- @treturn Pegasus server
----@param params table|nil
----@return Pegasus
+-- @tparam[opt='*'] string params.host bind address
+-- @tparam[opt=9090] string|number params.port bind port
+-- @tparam[opt=""] string params.location base directory used by some plugins
+-- @tparam[opt={}] table params.plugins list of plugins to be applied
+-- @tparam[opt=1] number params.timeout client socket timeout in seconds
+-- @tparam[opt] logger params.log a LuaLogging compatible logger object. Defaults to module `pegasus.log`.
+-- @return Pegasus server
 function Pegasus:new(params)
   params = params or {}
   local server = {}
@@ -84,10 +55,12 @@ end
 
 --- Start the server accept loop (blocking).
 --
--- The provided callback is invoked once per incoming HTTP request.
+-- Starts the server and handles incoming connections. The provided callback is invoked once per incoming HTTP request.
+-- Errors during `socket.bind` will raise; accept errors are logged and the loop continues.
 --
--- Example:
--- ```lua
+-- @tparam function callback using signature `stop_further_processing = function(request, response)`
+-- @raise on bind failure
+-- @usage
 -- server:start(function(request, response)
 --   -- inspect `request` (method, path, headers, body, query, etc.)
 --   -- then write a response
@@ -95,13 +68,6 @@ end
 --   response:addHeader('Content-Type', 'text/plain')
 --   response:write('OK')
 -- end)
--- ```
---
--- Errors during `socket.bind` will raise; accept errors are logged and the loop continues.
---
--- @tparam function callback function(request, response)
--- @raise on bind failure
----@param callback fun(request: table, response: table)
 function Pegasus:start(callback)
   local handler = Handler:new(callback, self.location, self.plugins, self.log)
   local server = assert(socket.bind(self.host, self.port))
diff --git a/src/pegasus/log.lua b/src/pegasus/log.lua
index 1d66194..80b5c42 100644
--- a/src/pegasus/log.lua
+++ b/src/pegasus/log.lua
@@ -1,8 +1,8 @@
--- logging
-
--- returns a LuaLogging compatible logger object.
+--- logging.
+-- Requiring this module returns a LuaLogging compatible logger object.
 -- If LuaLogging was already loaded, it returns the defaultlogger,
 -- otherwise returns a stub. The stub has only no-op functions.
+-- @module logging
 
 local ll = package.loaded.logging
 if ll and type(ll) == "table" and ll.defaultLogger and
diff --git a/src/pegasus/plugins/compress.lua b/src/pegasus/plugins/compress.lua
index 1a38c43..8e686b7 100644
--- a/src/pegasus/plugins/compress.lua
+++ b/src/pegasus/plugins/compress.lua
@@ -1,18 +1,23 @@
---- Module `pegasus.plugins.compress`
+--- gzip compression for responses.
 --
 -- Response body compressor that applies gzip when the client accepts it
 -- and compression is beneficial. Works with both `lua-zlib` and `lzlib`.
 --
 -- Behavior:
+--
 -- - Detects `Accept-Encoding: gzip` on the request (or `Content-Encoding` already set)
 -- - Sets `Content-Encoding: gzip` when compressing
 -- - Supports streaming with chunked encoding; maintains an internal zlib stream
 -- - Leaves content unchanged when compression does not reduce size
 --
--- Options for `Compress:new{ ... }`:
--- - `level`: zlib compression level (defaults to zlib default; use `NO_COMPRESSION` to disable)
+-- Levels:
+--
+-- - `plugin.NO_COMPRESSION` (0): no compression
+-- - `plugin.BEST_SPEED` (1): fastest compression
+-- - `plugin.BEST_COMPRESSION` (9): best compression ratio
+-- - `plugin.DEFAULT_COMPRESSION` (-1): zlib default
 --
--- @module pegasus.plugins.compress
+-- @classmod pegasus.plugins.compress
 
 local ZlibStream = {} do
   local zlib = require "zlib"
@@ -98,10 +103,8 @@ local Compress = {} do
 
   --- Create a new `Compress` plugin instance.
   -- @tparam[opt] table options
-  -- @tparam[opt] number options.level zlib compression level
-  -- @treturn table plugin instance
-  ---@param options table|nil
-  ---@return Compress
+  -- @tparam[opt=plugin.DEFAULT_COMPRESSION] number options.level zlib compression level (see constants above)
+  -- @return plugin instance
   function Compress:new(options)
     local compress = {}
     compress.options = options or {}
@@ -123,11 +126,6 @@ local Compress = {} do
   -- @tparam table request request object
   -- @tparam table response response object
   -- @treturn string data possibly compressed
-  ---@param data string|nil
-  ---@param stayOpen boolean
-  ---@param request table
-  ---@param response table
-  ---@return string
   function Compress:processBodyData(data, stayOpen, request, response)
     local accept_encoding
 
diff --git a/src/pegasus/plugins/downloads.lua b/src/pegasus/plugins/downloads.lua
index 4219d94..a70e929 100644
--- a/src/pegasus/plugins/downloads.lua
+++ b/src/pegasus/plugins/downloads.lua
@@ -1,16 +1,17 @@
---- Module `pegasus.plugins.downloads`
+--- Plugin that sends files downstream as downloads.
 --
 -- A plugin that exposes a virtual directory for file downloads. Matches
 -- a configurable `prefix` and serves files from a configured `location`
 -- using `Content-Disposition: attachment`.
 --
--- @module pegasus.plugins.downloads
--- @usage
--- local Downloads = require('pegasus.plugins.downloads')
--- local plugin = Downloads:new{ location = './public', prefix = 'downloads' }
--- -- Add plugin to Pegasus
---
 -- The plugin only responds to `GET` and `HEAD`.
+--
+-- Example:
+--
+--     local Downloads = require('pegasus.plugins.downloads')
+--     local plugin = Downloads:new{ location = './public', prefix = 'downloads' }
+--     -- Add plugin to Pegasus
+-- @classmod pegasus.plugins.downloads
 local Downloads = {}
 Downloads.__index = Downloads
 
@@ -19,20 +20,13 @@ Downloads.__index = Downloads
 -- same `location` setting as defined in the `Handler`. The `prefix` is a virtual folder
 -- that triggers the plugin, but will be removed from the filepath if `stripPrefix` is truthy.
 -- If `stripPrefix` is falsy, then it should be a real folder.
--- @tparam options table the options table with the following fields;
--- @tparam[opt="./"] options.location string the path to serve files from. Relative to the working directory.
--- @tparam[opt="downloads/"] options.prefix string the path prefix that triggers the plugin
--- @tparam options.stripPrefix bool whether to strip the prefix from the file path when looking
+-- @tparam table options the options table with the following fields;
+-- @tparam[opt="./"] string options.location the path to serve files from. Relative to the working directory.
+-- @tparam[opt="downloads/"] string options.prefix the path prefix that triggers the plugin
+-- @tparam bool options.stripPrefix whether to strip the prefix from the file path when looking
 -- for the file in the filesystem. Defaults to `false`, unless `options.prefix` is omitted,
 -- then it defaults to `true`.
 -- @return the new plugin
---- @tparam table options options table
---- @tparam[opt="./"] string options.location base directory (relative to cwd)
---- @tparam[opt="downloads/"] string options.prefix path prefix triggering the plugin
---- @tparam[opt] boolean options.stripPrefix whether to strip the prefix from the filesystem path
---- @treturn table plugin instance
----@param options table|nil
----@return Downloads
 function Downloads:new(options)
   options = options or {}
   local plugin = {}
@@ -74,12 +68,9 @@ function Downloads:new(options)
 end
 
 --- Handle a new request/response pair; serve a download when the path matches.
--- @tparam table request
--- @tparam table response
--- @treturn boolean stop whether request handling should stop
----@param request table
----@param response table
----@return boolean
+-- @tparam pegasus.request request
+-- @tparam pegasus.response response
+-- @treturn boolean stop returns true if the plugin found and wrote the file to the response.
 function Downloads:newRequestResponse(request, response)
   local stop = false
 
diff --git a/src/pegasus/plugins/files.lua b/src/pegasus/plugins/files.lua
index df67291..bb50151 100644
--- a/src/pegasus/plugins/files.lua
+++ b/src/pegasus/plugins/files.lua
@@ -1,9 +1,8 @@
---- Module `pegasus.plugins.files`
+--- Plugin that serves static content.
 --
 -- A plugin that serves static content from a folder and optionally redirects
--- `/` to a configured default file.
---
--- @module pegasus.plugins.files
+-- `"/"` to a configured default file.
+-- @classmod pegasus.plugins.files
 
 local mimetypes = require 'mimetypes'
 
@@ -14,13 +13,11 @@ Files.__index = Files
 --- Creates a new plugin instance.
 -- The plugin will only respond to `GET` requests. The files will be served from the
 -- `location` folder.
--- @tparam options table the options table with the following fields;
--- @tparam[opt="./"] options.location string the path to serve files from. Relative to the working directory.
--- @tparam[opt="index.html"] options.default string filename to serve for top-level without path. Use an empty
+-- @tparam table options the options table with the following fields;
+-- @tparam[opt="./"] string options.location the path to serve files from. Relative to the working directory.
+-- @tparam[opt="index.html"] string options.default filename to serve for top-level without path. Use an empty
 -- string to have none.
 -- @return the new plugin
----@param options table|nil
----@return Files
 function Files:new(options)
   options = options or {}
   local plugin = {}
@@ -54,15 +51,9 @@ end
 
 
 --- Handle a new request/response pair; serve static files.
--- - Redirects `/` to `options.default` when set
--- - Serves `GET`/`HEAD` only
---
--- @tparam table request
--- @tparam table response
--- @treturn boolean stop whether request handling should stop
----@param request table
----@param response table
----@return boolean
+-- @tparam pegasus.request request
+-- @tparam pegasus.response response
+-- @treturn boolean stop returns true if the plugin found and wrote the file to the response.
 function Files:newRequestResponse(request, response)
   local stop = false
 
diff --git a/src/pegasus/plugins/router.lua b/src/pegasus/plugins/router.lua
index d291287..ecd6b03 100644
--- a/src/pegasus/plugins/router.lua
+++ b/src/pegasus/plugins/router.lua
@@ -1,10 +1,8 @@
---- Module `pegasus.plugins.router`
+--- A router plugin for handling paths/methods/path-parameters.
 --
 -- A plugin that routes requests based on path and method, with support for
 -- path parameters and pre/post hooks at both router and path levels.
 --
--- @module pegasus.plugins.router
---
 -- Supports path parameters.
 --
 -- The `routes` table to configure the router is a hash-table where the keys are the path, and
@@ -21,7 +19,7 @@
 -- * the path `preFunction` callback is called when there is a `path` match. It can
 -- be used to do some validations, like path parameters, etc. It is defined on `path` level.
 --
--- * the `METHOD` (eg. `GET, `POST`, etc) this callback implements the specific method. It is defined
+-- * the `METHOD` (eg. `GET`, `POST`, etc) this callback implements the specific method. It is defined
 -- once for each supported method on the path. The special case is method "`*`" which is a catch-all.
 -- The catch-all will be used for any method that doesn't have its own handler defined.
 -- If omitted, the default catch-all will return a "405 Method Not Allowed" error.
@@ -42,79 +40,82 @@
 -- Route matching is based on a complete match (not prefix). And the order is based on the number
 -- of path-parameters defined. Least number of parameters go first, such that static paths have
 -- precedence over variables.
--- @usage
--- local routes = {
---   preFunction = function(req, resp)
---     local stop = false
---     -- this gets called before any path specific callback
 --
---     if some_error then
---       resp:writeDefaultErrorMessage(400)
---       stop = true
---     end
---     return stop
---   end,
+-- Example:
+--
+--     local routes = {
+--       preFunction = function(req, resp)
+--         local stop = false
+--         -- this gets called before any path specific callback
 --
+--         if some_error then
+--           resp:writeDefaultErrorMessage(400)
+--           stop = true
+--         end
+--         return stop
+--       end,
 --
---   ["/my/{accountNumber}/{param2}/endpoint"] = { -- define path parameters
 --
---     preFunction = function(req, resp)
---       local stop = false
---       -- this gets called before any method specific callback,
---       -- but after the path-preFunction
---       return stop
---     end,
+--       ["/my/{accountNumber}/{param2}/endpoint"] = { -- define path parameters
 --
---     GET = function(req, resp)
---       local stop = false
---       -- this implements the main GET logic
---       return stop
---     end,
+--         preFunction = function(req, resp)
+--           local stop = false
+--           -- this gets called before any method specific callback,
+--           -- but after the router-preFunction
+--           return stop
+--         end,
 --
---     POST = function(req, resp)
---       local stop = false
---       -- this implements the main POST logic
---       return stop
---     end,
+--         GET = function(req, resp)
+--           local stop = false
+--           -- this implements the main GET logic
+--           return stop
+--         end,
 --
---     ["*"] = function(req, resp)
---       local stop = false
---       -- this implements the wildcard, will handle any method except for the
---       -- GET/POST ones defined above.
+--         POST = function(req, resp)
+--           local stop = false
+--           -- this implements the main POST logic
+--           return stop
+--         end,
 --
---       -- If the wildcard is not defined, then a default one will be added which
---       -- only returns a "405 Method Not Allowed" error.
---       return stop
---     end,
+--         ["*"] = function(req, resp)
+--           local stop = false
+--           -- this implements the wildcard, will handle any method except for the
+--           -- GET/POST ones defined above.
 --
---     postFunction = function(req, resp)
---       local stop = false
---       -- this gets called before after the method specific (or wildcard)
---       -- callback.
+--           -- If the wildcard is not defined, then a default one will be added which
+--           -- only returns a "405 Method Not Allowed" error.
+--           return stop
+--         end,
 --
---       return stop
---     end,
---   },
+--         postFunction = function(req, resp)
+--           local stop = false
+--           -- this gets called after the method specific (or wildcard)
+--           -- callback.
 --
---   ["/my/endpoint"] = function(req, resp)
---     local stop = false
---     -- this is a shortcut to create a wildcard-method, one callback
---     -- to handle any method for this path. Identical to:
---     -- ["/my/endpoint"] = { ["*"] = function(req, resp) ... end }
---     return stop
---   end,
+--           return stop
+--         end,
+--       },
 --
---   postFunction = function(req, resp)
---     local stop = false
---     -- this gets called last.
---     return stop
---   end,
--- }
+--       ["/my/endpoint"] = function(req, resp)
+--         local stop = false
+--         -- this is a shortcut to create a wildcard-method, one callback
+--         -- to handle any method for this path. Identical to:
+--         -- ["/my/endpoint"] = { ["*"] = function(req, resp) ... end }
+--         return stop
+--       end,
 --
--- local router = Router:new {
---   prefix = "/api/1v0/",
---   routes = routes,
--- }
+--       postFunction = function(req, resp)
+--         local stop = false
+--         -- this gets called last.
+--         return stop
+--       end,
+--     }
+--
+--     local router = Router:new {
+--       prefix = "/api/1v0/",
+--       routes = routes,
+--     }
+-- @classmod pegasus.plugins.router
 
 
 
@@ -140,7 +141,7 @@ end
 
 
 
---- Router plugin instance.
+-- Router plugin instance.
 --
 -- Options passed to `Router:new{ ... }`:
 -- - `prefix` (string, optional): base path for all routes
@@ -148,9 +149,6 @@ end
 --
 -- Methods invoked by the handler:
 -- - `newRequestResponse(request, response)`
---
--- @type Router
----@class Router
 
 local Router = {}
 Router.__index = Router
@@ -242,15 +240,13 @@ end
 
 
 --- Creates a new Router plugin instance.
--- @tparam options table the options table with the following fields;
--- @tparam[opt] options.prefix string the base path for all underlying routes.
--- @tparam options.routes table route definitions to be handled by this router plugin instance.
--- @tparam[opt] options.errorHandler function an optional error handler function with signature
+-- @tparam table options the options table with the following fields;
+-- @tparam[opt] string options.prefix the base path for all underlying routes.
+-- @tparam table options.routes route definitions to be handled by this router plugin instance.
+-- @tparam[opt] function options.errorHandler an optional error handler function with signature
 -- `message_to_log = function(request, response, errobj)`. The default handler will send a 500 error
 -- response, and return a stack trace for logging.
 -- @return the new plugin
----@param options table|nil
----@return Router
 function Router:new(options)
   options = options or {}
   local plugin = {}
@@ -315,9 +311,6 @@ end
 -- @tparam table request
 -- @tparam table response
 -- @treturn boolean stop whether request handling should stop
----@param request table
----@param response table
----@return boolean
 function Router:newRequestResponse(request, response)
 
   local errh = function(...) -- error function that injects request/response objects
diff --git a/src/pegasus/plugins/tls.lua b/src/pegasus/plugins/tls.lua
index 2963223..64c8098 100644
--- a/src/pegasus/plugins/tls.lua
+++ b/src/pegasus/plugins/tls.lua
@@ -1,14 +1,13 @@
---- Module `pegasus.plugins.tls`
+--- Implements TLS for secure connections.
 --
 -- A plugin that enables TLS (https) for connections using LuaSec.
 -- Should be the first plugin, since it wraps the client socket and performs
 -- the TLS handshake before any other plugin or handler accesses the socket.
 --
--- @module pegasus.plugins.tls
---
 -- This plugin should not be used with Copas. Since Copas has native TLS support
 -- and can handle simultaneous `http` and `https` connections. See the Copas example
 -- to learn how to set that up.
+-- @classmod pegasus.plugins.tls
 local ssl = require("ssl")
 
 
@@ -18,7 +17,7 @@ TLS.__index = TLS
 
 --- Creates a new plugin instance.
 -- IMPORTANT: this must be the first plugin to execute before the client-socket is accessed!
--- @tparam sslparams table the data-structure that contains the properties for the luasec functions.
+-- @tparam table sslparams the data-structure that contains the properties for the luasec functions.
 -- The structure is set up to mimic the LuaSec functions for the handshake.
 -- @return the new plugin
 -- @usage
@@ -30,8 +29,6 @@ TLS.__index = TLS
 --   }
 -- }
 -- local tls_plugin = require("pegasus.plugins.tls"):new(sslparams)
----@param sslparams table|nil
----@return TLS
 function TLS:new(sslparams)
   sslparams = sslparams or {}
   assert(sslparams.wrap, "'sslparam.wrap' is a required option")
@@ -43,12 +40,9 @@ end
 
 --- Wrap an accepted client socket and perform the TLS handshake.
 -- Optionally sets SNI if provided in `sslparams`.
--- @tparam table client accepted client socket
--- @tparam table handler the Pegasus handler (for logging)
--- @treturn table|false wrapped client or false on failure
----@param client table
----@param handler table
----@return table|false
+-- @tparam socket client accepted client socket
+-- @tparam pegasus.handler handler the Pegasus handler (for logging)
+-- @treturn socket|false wrapped client socket or `false` on failure
 function TLS:newConnection(client, handler)
   local params = self.sslparams
 
diff --git a/src/pegasus/request.lua b/src/pegasus/request.lua
index 111388c..5bbefe5 100644
--- a/src/pegasus/request.lua
+++ b/src/pegasus/request.lua
@@ -1,25 +1,31 @@
---- Module `pegasus.request`
+--- Request object available in callback handlers.
 --
--- Parsed HTTP request facade used by your application callback.
--- Instances are created internally by Pegasus and passed to
--- `server:start(function(request, response) ... end)`.
+-- Parsed HTTP request facade used by your application callback. Instances are
+-- created internally by Pegasus and passed to the callback provided to `pegasus:start`,
+-- and plugin handlers.
+--
+-- Fields on the object:
+--
+-- * `request.client`: the client socket (wrapped by TLS if TLS plugin is used)
+-- * `request.server`: the server socket
+-- * `request.log`: the logger object, to enable logging from handlers and plugins
+-- * `request.port`: the port on which the request was received
+-- * `request.ip`: the IP address of the client, if available (not supported by LuaSec)
+-- * `request.response`: the related `pegasus.response` object to write the response to
 --
 -- Quick example:
--- ```lua
--- server:start(function(req, res)
---   local method = req:method()
---   local path = req:path()
---   local headers = req:headers()
---   local qs = req.querystring -- table of query params
 --
---   if method == 'POST' then
---     local form = req:post() -- urlencoded form body, or nil if not POST
---   end
--- end)
--- ```
+--     server:start(function(req, res)
+--       local method = req:method()
+--       local path = req:path()
+--       local headers = req:headers()
+--       local qs = req.querystring -- table of query params
 --
--- @module pegasus.request
-
+--       if method == 'POST' then
+--         local form = req:post() -- urlencoded form body, or nil if not POST
+--       end
+--     end)
+-- @classmod pegasus.request
 local Response = require 'pegasus.response'
 
 local function normalizePath(path)
@@ -50,35 +56,7 @@ local function normalizePath(path)
   return value
 end
 
---- The HTTP request object.
---
--- Fields:
--- - `client`: the underlying accepted socket client.
--- - `server`: the listening server socket.
--- - `log`: logger compatible with `pegasus.log` API.
--- - `port`: server port bound.
--- - `ip`: remote peer address if available (may be `nil` under TLS).
--- - `querystring`: table of parsed query-string parameters. Values may be a string or a table of strings if repeated.
--- - `response`: associated `Response` object, with a back-reference via `response.request`.
---
--- Methods of interest:
--- - `method()` -> string
--- - `path()` -> string
--- - `headers()` -> case-insensitive table of headers (values string or table)
--- - `receiveBody([size])` -> string|false (chunked read of request body)
--- - `post()` -> table|nil (parses `application/x-www-form-urlencoded` body when method is POST)
---
--- Internal helpers: `parseFirstLine`, `parseUrlEncoded`.
---
--- @type Request
----@class Request
----@field client table
----@field server table
----@field log table
----@field port string|integer
----@field ip string|nil
----@field querystring table
----@field response table
+
 local Request = {}
 Request.__index = Request
 Request.PATTERN_METHOD = '^(.-)%s'
@@ -89,18 +67,13 @@ Request.PATTERN_PATH ..Request.PATTERN_PROTOCOL)
 Request.PATTERN_QUERY_STRING = '([^=]*)=([^&]*)&?'
 Request.PATTERN_HEADER = '([%w-]+):[ \t]*([%w \t%p]*)'
 
---- Internal: construct a new Request.
+-- Internal: construct a new Request.
 --
 -- @tparam string|number port server port
 -- @tparam table client accepted client socket
 -- @tparam table server listening server socket
 -- @tparam table handler internal handler (provides `log` and body processing)
 -- @treturn Request request
----@param port string|integer
----@param client table
----@param server table
----@param handler table
----@return Request
 function Request:new(port, client, server, handler)
   local obj = {}
   obj.client = client
@@ -123,7 +96,7 @@ function Request:new(port, client, server, handler)
   return setmetatable(obj, self)
 end
 
---- Internal: parse the request line and query-string on first access.
+-- Internal: parse the request line and query-string on first access.
 function Request:parseFirstLine()
   if (self._firstLine ~= nil) then
     return
@@ -162,11 +135,9 @@ function Request:parseFirstLine()
 end
 
 --- Parse `application/x-www-form-urlencoded` data.
--- Returns a table where duplicate keys are represented as an array of values.
+-- Returns a hash table. Duplicate keys are represented as an array of values.
 -- @tparam string data
 -- @treturn table params
----@param data string|nil
----@return table
 function Request:parseUrlEncoded(data)
   local output = {}
 
@@ -188,11 +159,10 @@ function Request:parseUrlEncoded(data)
   return output
 end
 
---- Convenience: parse POST body as `application/x-www-form-urlencoded`.
+--- parse POST body as `application/x-www-form-urlencoded`.
 -- Returns `nil` if method is not POST.
--- @treturn[1] table parsed form values
+-- @treturn[1] table parsed form values, see `parseUrlEncoded` for details on the format of this table.
 -- @treturn[2] nil when not a POST request
----@return table|nil
 function Request:post()
   if self:method() ~= 'POST' then return nil end
   local data = self:receiveBody()
@@ -201,7 +171,6 @@ end
 
 --- Request path (normalized), without query-string.
 -- @treturn string path
----@return string
 function Request:path()
   self:parseFirstLine()
   return self._path
@@ -209,7 +178,6 @@ end
 
 --- HTTP method.
 -- @treturn string method
----@return string
 function Request:method()
   self:parseFirstLine()
   return self._method
@@ -227,7 +195,6 @@ end
 -- Returns a case-insensitive table: looking up with any casing works.
 -- If a header appears multiple times, the value becomes a table of strings.
 -- @treturn table headers
----@return table
 function Request:headers()
   if self._headerParsed then
     return self._headers
@@ -277,8 +244,6 @@ end
 -- When a socket timeout happens, any partial data is returned.
 -- @tparam[opt] number size preferred chunk size
 -- @treturn string|false chunk or false if no more content
----@param size number|nil
----@return string|false
 function Request:receiveBody(size)
   if not self._headerParsed then
     self:headers()
diff --git a/src/pegasus/response.lua b/src/pegasus/response.lua
index b5ba939..341135b 100644
--- a/src/pegasus/response.lua
+++ b/src/pegasus/response.lua
@@ -1,19 +1,28 @@
---- Module `pegasus.response`
+--- Response object available in callback handlers.
 --
 -- HTTP response writer used by your application callback.
 -- Instances are created internally by Pegasus and passed to
--- `server:start(function(request, response) ... end)`.
+-- the callback provided to `pegasus:start` and plugin handlers.
+--
+-- Notes:
+--
+-- - When streaming (`stayOpen == true`), Transfer-Encoding: chunked is used.
+-- - For HEAD requests, bodies are automatically skipped.
+--
+-- Fields on the object:
+--
+-- * `response.log`: the logger object, to enable logging from handlers and plugins
+-- * `response.request`: the related `pegasus.request` object
+-- * `response.status`: the HTTP status code (defaults to 200), use `response:statusCode` to set the status
 --
 -- Quick example:
--- ```lua
--- server:start(function(req, res)
---   res:statusCode(200)
---      :contentType('application/json')
---      :write('{"ok":true}')
--- end)
--- ```
 --
--- @module pegasus.response
+--     server:start(function(req, res)
+--       res:statusCode(200)
+--          :contentType('application/json')
+--          :write('{"ok":true}')
+--     end)
+-- @classmod pegasus.response
 
 local mimetypes = require 'mimetypes'
 
@@ -99,38 +108,14 @@ local DEFAULT_ERROR_MESSAGE = [[
 </html>
 ]]
 
---- The HTTP response object.
---
--- Usage pattern: chainable calls for fluent responses.
---
--- Methods of interest:
--- - `statusCode(code[, text])`
--- - `contentType(value)` / `addHeader(name, value)` / `addHeaders(table)`
--- - `write(body[, stayOpen])` (streams when `stayOpen == true`)
--- - `close()` (finish chunked stream)
--- - `writeFile(path[, contentType])` (200 OK)
--- - `sendFile(path)` (attachment)
--- - `redirect(location[, temporary])`
---
--- Notes:
--- - When streaming (`stayOpen == true`), Transfer-Encoding: chunked is used.
--- - For HEAD requests, bodies are automatically skipped.
---
--- @type Response
----@class Response
----@field status integer
----@field request table
+
 local Response = {}
 Response.__index = Response
 
---- Internal: construct a new Response.
---
+-- Internal: construct a new Response.
 -- @tparam table client accepted client socket
 -- @tparam table writeHandler internal handler (provides `log` and body processing)
 -- @treturn Response response
----@param client table
----@param writeHandler table
----@return Response
 function Response:new(client, writeHandler)
   local newObj = {}
   newObj.log = writeHandler.log
@@ -148,13 +133,10 @@ function Response:new(client, writeHandler)
 end
 
 --- Add a response header.
--- Errors if headers were already sent.
+-- Errors if headers were already sent downstream.
 -- @tparam string key
--- @tparam string|number|table value
--- @treturn Response self
----@param key string
----@param value any
----@return Response
+-- @tparam string|number|array value (multiple headers by the same name can be set by passing an array of values)
+-- @return The `pegasus.response` object to allow chaining calls.
 function Response:addHeader(key, value)
   assert(not self._headersSended, "can't add header, they were already sent")
   self._headers[key] = value
@@ -162,10 +144,8 @@ function Response:addHeader(key, value)
 end
 
 --- Add multiple headers.
--- @tparam table params
--- @treturn Response self
----@param params table
----@return Response
+-- @tparam table params table of key-value pairs to add as headers (see `addHeader` for value types)
+-- @return The `pegasus.response` object to allow chaining calls.
 function Response:addHeaders(params)
   for key, value in pairs(params) do
     self:addHeader(key, value)
@@ -176,21 +156,16 @@ end
 
 --- Set the `Content-Type` header.
 -- @tparam string value
--- @treturn Response self
----@param value string
----@return Response
+-- @return The `pegasus.response` object to allow chaining calls.
 function Response:contentType(value)
   return self:addHeader('Content-Type', value)
 end
 
 --- Set the HTTP status line.
--- Must be called before headers are sent.
+-- Must be called before headers are sent downstream.
 -- @tparam number statusCode
 -- @tparam[opt] string statusText (defaults to standard text for the code)
--- @treturn Response self
----@param statusCode integer
----@param statusText string|nil
----@return Response
+-- @return The `pegasus.response` object to allow chaining calls.
 function Response:statusCode(statusCode, statusText)
   assert(not self._headersSended, "can't set status code, it was already sent")
   self.status = statusCode
@@ -200,18 +175,20 @@ function Response:statusCode(statusCode, statusText)
   return self
 end
 
---- Skip writing the response body (used for HEAD requests).
--- @tparam[opt] boolean skip defaults to true
----@param skip boolean|nil
+--- Instruct response to skip writing the response body.
+-- This is automatically called by the `pegasus.request` object for HEAD requests. There should be no need
+-- to call this manually.
+-- @tparam[opt=true] boolean skip
+-- @return The `pegasus.response` object to allow chaining calls.
 function Response:skipBody(skip)
   if skip == nil then
     skip = true
   end
   self._skipBody = not not skip
+  return self
 end
 
---- Internal: serialize headers.
----@return string
+-- Internal: serialize headers.
 function Response:_getHeaders()
   local headers = {}
 
@@ -231,10 +208,7 @@ end
 --- Write a default HTML error body for a given status.
 -- @tparam number statusCode
 -- @tparam[opt] string errMessage
--- @treturn Response self
----@param statusCode integer
----@param errMessage string|nil
----@return Response
+-- @return The `pegasus.response` object to allow chaining calls.
 function Response:writeDefaultErrorMessage(statusCode, errMessage)
   self:statusCode(statusCode)
   local content = string.gsub(DEFAULT_ERROR_MESSAGE, '{{ STATUS_CODE }}', statusCode)
@@ -245,8 +219,7 @@ end
 
 --- Finish a chunked response and mark as closed.
 -- Idempotent; safe to call multiple times.
--- @treturn Response self
----@return Response
+-- @return The `pegasus.response` object to allow chaining calls.
 function Response:close()
   if not self.closed then
     local body = self._writeHandler:processBodyData(nil, true, self)
@@ -267,8 +240,7 @@ end
 
 --- Send only the headers, without a body.
 -- Useful for redirects and HEAD responses.
--- @treturn Response self
----@return Response
+-- @return The `pegasus.response` object to allow chaining calls.
 function Response:sendOnlyHeaders()
   self:sendHeaders(false, '')
   self:write('\r\n')
@@ -279,12 +251,9 @@ end
 --- Send headers if not already sent.
 -- Adds `Transfer-Encoding: chunked` when `stayOpen == true`; otherwise sets `Content-Length` when body is a string.
 -- Also sets a default `Date` and `Content-Type` header if not present.
--- @tparam boolean stayOpen whether to keep the connection open for chunked streaming
+-- @tparam[opt=false] boolean stayOpen whether to keep the connection open for chunked streaming
 -- @tparam[opt] string body current body chunk (used to set Content-Length)
--- @treturn Response self
----@param stayOpen boolean
----@param body string|nil
----@return Response
+-- @return The `pegasus.response` object to allow chaining calls.
 function Response:sendHeaders(stayOpen, body)
   if self._headersSended then
     return self
@@ -311,14 +280,10 @@ end
 
 --- Write response body.
 -- When `stayOpen == true`, the body is sent as a chunk and the connection remains open.
--- When `stayOpen ~= true`, headers are sent with `Content-Length` and the socket is closed afterwards.
--- `nil` body is treated as empty string.
--- @tparam[opt] string body
+-- When `stayOpen ~= true`, headers are sent with `Content-Length` and the client-socket is closed afterwards.
+-- @tparam[opt=""] string body
 -- @tparam[opt] boolean stayOpen
--- @treturn Response self
----@param body string|nil
----@param stayOpen boolean|nil
----@return Response
+-- @return The `pegasus.response` object to allow chaining calls.
 function Response:write(body, stayOpen)
   body = self._writeHandler:processBodyData(body or '', stayOpen, self)
   self:sendHeaders(stayOpen, body)
@@ -354,14 +319,10 @@ local function readfile(filename)
 end
 
 --- Write a file to the response with a 200 status.
--- Returns nil+err if file cannot be read.
--- @tparam string|file* filename path or legacy file descriptor (deprecated)
--- @tparam[opt] string contentType override content type
--- @treturn[1] Response self
--- @treturn[2] nil,error on failure
----@param filename any
----@param contentType string|nil
----@return Response|nil,any
+-- @tparam string filename path to file
+-- @tparam[opt] string contentType override content type, if omitted it will be guessed based on the filename extension
+-- @return[1] The `pegasus.response` object to allow chaining calls.
+-- @return[2] nil + err on failure
 function Response:writeFile(filename, contentType)
   if type(filename) ~= "string" then
     -- deprecated backward compatibility; file is a file-descriptor
@@ -385,12 +346,9 @@ function Response:writeFile(filename, contentType)
 end
 
 --- Send a file as an attachment (download).
--- Returns nil+err if the file cannot be read.
--- @tparam string path filesystem path
--- @treturn[1] Response self
--- @treturn[2] nil,error on failure
----@param path string
----@return Response|nil,any
+-- @tparam string path path to file
+-- @return[1] The `pegasus.response` object to allow chaining calls.
+-- @return[2] nil + err on failure
 function Response:sendFile(path)
   local filename = path:match("[^/]*$") -- only filename, no path
   self:addHeader('Content-Disposition', 'attachment; filename="' .. filename .. '"')
@@ -407,10 +365,7 @@ end
 --- Redirect to a different URL.
 -- @tparam string location destination URL
 -- @tparam[opt] boolean temporary when true uses 302, otherwise 301
--- @treturn Response self
----@param location string
----@param temporary boolean|nil
----@return Response
+-- @return The `pegasus.response` object to allow chaining calls.
 function Response:redirect(location, temporary)
   self:statusCode(temporary and 302 or 301)
   self:addHeader('Location', location)

From a4dab253b48212cdb78bf9a9f3ee2fd14e8110d2 Mon Sep 17 00:00:00 2001
From: Thijs Schreijer <thijs@thijsschreijer.nl>
Date: Mon, 30 Mar 2026 13:30:03 +0200
Subject: [PATCH 3/3] chore(docs): add rendered docs

---
 docs/classes/pegasus.handler.html           | 230 ++++++++
 docs/classes/pegasus.html                   | 226 +++++++
 docs/classes/pegasus.plugins.compress.html  | 210 +++++++
 docs/classes/pegasus.plugins.downloads.html | 207 +++++++
 docs/classes/pegasus.plugins.files.html     | 183 ++++++
 docs/classes/pegasus.plugins.router.html    | 307 ++++++++++
 docs/classes/pegasus.plugins.tls.html       | 186 ++++++
 docs/classes/pegasus.request.html           | 333 +++++++++++
 docs/classes/pegasus.response.html          | 583 ++++++++++++++++++
 docs/examples/app.lua.html                  | 215 +++++++
 docs/examples/app_stream.lua.html           | 105 ++++
 docs/examples/copas.lua.html                | 264 +++++++++
 docs/examples/querystring.lua.html          | 104 ++++
 docs/examples/write.lua.html                |  95 +++
 docs/index.html                             | 159 +++++
 docs/ldoc.css                               | 618 ++++++++++++++++++++
 docs/modules/logging.html                   |  92 +++
 docs/topics/LICENSE.html                    | 100 ++++
 docs/topics/README.md.html                  | 315 ++++++++++
 19 files changed, 4532 insertions(+)
 create mode 100644 docs/classes/pegasus.handler.html
 create mode 100644 docs/classes/pegasus.html
 create mode 100644 docs/classes/pegasus.plugins.compress.html
 create mode 100644 docs/classes/pegasus.plugins.downloads.html
 create mode 100644 docs/classes/pegasus.plugins.files.html
 create mode 100644 docs/classes/pegasus.plugins.router.html
 create mode 100644 docs/classes/pegasus.plugins.tls.html
 create mode 100644 docs/classes/pegasus.request.html
 create mode 100644 docs/classes/pegasus.response.html
 create mode 100644 docs/examples/app.lua.html
 create mode 100644 docs/examples/app_stream.lua.html
 create mode 100644 docs/examples/copas.lua.html
 create mode 100644 docs/examples/querystring.lua.html
 create mode 100644 docs/examples/write.lua.html
 create mode 100644 docs/index.html
 create mode 100644 docs/ldoc.css
 create mode 100644 docs/modules/logging.html
 create mode 100644 docs/topics/LICENSE.html
 create mode 100644 docs/topics/README.md.html

diff --git a/docs/classes/pegasus.handler.html b/docs/classes/pegasus.handler.html
new file mode 100644
index 0000000..13535eb
--- /dev/null
+++ b/docs/classes/pegasus.handler.html
@@ -0,0 +1,230 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+<head>
+    <title>Pegasus webserver in Lua</title>
+    <link rel="stylesheet" href="../ldoc.css" type="text/css" />
+</head>
+<body>
+
+<div id="container">
+
+<div id="product">
+	<div id="product_logo"></div>
+	<div id="product_name"><big><b></b></big></div>
+	<div id="product_description"></div>
+</div> <!-- id="product" -->
+
+
+<div id="main">
+
+
+<!-- Menu -->
+
+<div id="navigation">
+<br/>
+<h1>Pegasus</h1>
+
+
+<ul>
+  <li><a href="../index.html">Index</a></li>
+</ul>
+
+<h2>Contents</h2>
+<ul>
+<li><a href="#Functions">Functions</a></li>
+</ul>
+
+
+<h2>Classes</h2>
+<ul class="nowrap">
+  <li><a href="../classes/pegasus.html">pegasus</a></li>
+  <li><strong>pegasus.handler</strong></li>
+  <li><a href="../classes/pegasus.plugins.compress.html">pegasus.plugins.compress</a></li>
+  <li><a href="../classes/pegasus.plugins.downloads.html">pegasus.plugins.downloads</a></li>
+  <li><a href="../classes/pegasus.plugins.files.html">pegasus.plugins.files</a></li>
+  <li><a href="../classes/pegasus.plugins.router.html">pegasus.plugins.router</a></li>
+  <li><a href="../classes/pegasus.plugins.tls.html">pegasus.plugins.tls</a></li>
+  <li><a href="../classes/pegasus.request.html">pegasus.request</a></li>
+  <li><a href="../classes/pegasus.response.html">pegasus.response</a></li>
+</ul>
+<h2>Modules</h2>
+<ul class="nowrap">
+  <li><a href="../modules/logging.html">logging</a></li>
+</ul>
+<h2>Topics</h2>
+<ul class="">
+  <li><a href="../topics/LICENSE.html">LICENSE</a></li>
+  <li><a href="../topics/README.md.html">README</a></li>
+</ul>
+<h2>Examples</h2>
+<ul class="nowrap">
+  <li><a href="../examples/app.lua.html">app.lua</a></li>
+  <li><a href="../examples/app_stream.lua.html">app_stream.lua</a></li>
+  <li><a href="../examples/copas.lua.html">copas.lua</a></li>
+  <li><a href="../examples/querystring.lua.html">querystring.lua</a></li>
+  <li><a href="../examples/write.lua.html">write.lua</a></li>
+</ul>
+
+</div>
+
+<div id="content">
+
+<h1>Class <code>pegasus.handler</code></h1>
+<p>Internal handler that drives the request/response cycle.</p>
+<p>
+
+
+<p> Internal orchestrator that wires the server socket to request/response
+ objects and drives the plugin pipeline.</p>
+
+<p> Lifecycle for each connection/request:</p>
+
+<ol>
+    <li><code>pluginsNewConnection(client)</code> can wrap/replace or reject the client</li>
+    <li>Request/Response objects are created</li>
+    <li><code>pluginsNewRequestResponse(request, response)</code> runs</li>
+    <li><code>pluginsBeforeProcess(request, response)</code> runs</li>
+    <li>User <code>callback(request, response)</code> is invoked</li>
+    <li><code>pluginsAfterProcess(request, response)</code> runs</li>
+    <li>If response not closed, a default 404 is written</li>
+</ol>
+
+<p> Plugins may also:</p>
+
+<ul>
+    <li>modify Request/Response metatables via <code>alterRequestResponseMetaTable</code></li>
+    <li>intercept file processing via <code>processFile</code></li>
+    <li>filter/transform streamed body via <code>processBodyData</code></li>
+</ul>
+
+<p> Minimal plugin example:</p>
+
+
+<pre>
+<span class="keyword">local</span> MyPlugin = {}
+
+<span class="keyword">function</span> MyPlugin:<span class="function-name">new</span>()
+  <span class="keyword">return</span> <span class="global">setmetatable</span>({}, { __index = self })
+<span class="keyword">end</span>
+
+<span class="keyword">function</span> MyPlugin:<span class="function-name">beforeProcess</span>(req, res)
+  res:<span class="function-name">addHeader</span>(<span class="string">'X-Powered-By'</span>, <span class="string">'Pegasus'</span>)
+<span class="keyword">end</span>
+
+<span class="keyword">return</span> MyPlugin
+</pre>
+
+</p>
+
+
+<h2><a href="#Functions">Functions</a></h2>
+<table class="function_list">
+	<tr>
+	<td class="name" nowrap><a href="#Handler:new">Handler:new (callback, location, plugins, logger)</a></td>
+	<td class="summary">Construct a <code>Handler</code>.</td>
+	</tr>
+	<tr>
+	<td class="name" nowrap><a href="#Handler:processRequest">Handler:processRequest (port, client, server)</a></td>
+	<td class="summary">Process a single client by creating <code>Request</code>/<code>Response</code> and running pipeline.</td>
+	</tr>
+</table>
+
+<br/>
+<br/>
+
+
+    <h2 class="section-header "><a name="Functions"></a>Functions</h2>
+    Methods
+    <dl class="function">
+    <dt>
+    <a name = "Handler:new"></a>
+    <strong>Handler:new (callback, location, plugins, logger)</strong>
+    </dt>
+    <dd>
+    Construct a <code>Handler</code>. </p>
+
+<p> When <code>location</code> is a non-empty string, automatically enables the <code>files</code>
+ plugin to serve static files from that directory (default index <code>/index.html</code>).
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">callback</span>
+            <span class="types"><span class="type">function</span></span>
+         using signature <code>stop_further_processing = function(request, response)</code>
+        </li>
+        <li><span class="parameter">location</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
+         base directory for static files (optional)
+        </li>
+        <li><span class="parameter">plugins</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.6">table</a></span>
+         list of plugin instances (optional)
+        </li>
+        <li><span class="parameter">logger</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.6">table</a></span>
+         logger instance (optional)
+        </li>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+           <span class="types"><span class="type">Handler</span></span>
+        handler
+    </ol>
+
+
+
+
+</dd>
+    <dt>
+    <a name = "Handler:processRequest"></a>
+    <strong>Handler:processRequest (port, client, server)</strong>
+    </dt>
+    <dd>
+    Process a single client by creating <code>Request</code>/<code>Response</code> and running pipeline.
+ If the callback does not close the response, a default 404 page is sent.
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">port</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a> or <span class="type">number</span></span>
+         server port
+        </li>
+        <li><span class="parameter">client</span>
+            <span class="types"><span class="type">socket</span></span>
+         accepted client socket
+        </li>
+        <li><span class="parameter">server</span>
+            <span class="types"><span class="type">socket</span></span>
+         listening server socket
+        </li>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+           <span class="types"><span class="type">boolean</span> or <span class="type">nil</span></span>
+        <code>false</code> when connection was rejected by a plugin, <code>nil</code> on normal completion
+    </ol>
+
+
+
+
+</dd>
+</dl>
+
+
+</div> <!-- id="content" -->
+</div> <!-- id="main" -->
+<div id="about">
+<i>generated by <a href="http://github.com/lunarmodules/ldoc">LDoc 1.5.0</a></i>
+<i style="float:right;">Last updated 2026-03-30 13:29:33 </i>
+</div> <!-- id="about" -->
+</div> <!-- id="container" -->
+</body>
+</html>
diff --git a/docs/classes/pegasus.html b/docs/classes/pegasus.html
new file mode 100644
index 0000000..ed23c62
--- /dev/null
+++ b/docs/classes/pegasus.html
@@ -0,0 +1,226 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+<head>
+    <title>Pegasus webserver in Lua</title>
+    <link rel="stylesheet" href="../ldoc.css" type="text/css" />
+</head>
+<body>
+
+<div id="container">
+
+<div id="product">
+	<div id="product_logo"></div>
+	<div id="product_name"><big><b></b></big></div>
+	<div id="product_description"></div>
+</div> <!-- id="product" -->
+
+
+<div id="main">
+
+
+<!-- Menu -->
+
+<div id="navigation">
+<br/>
+<h1>Pegasus</h1>
+
+
+<ul>
+  <li><a href="../index.html">Index</a></li>
+</ul>
+
+<h2>Contents</h2>
+<ul>
+<li><a href="#Functions">Functions</a></li>
+</ul>
+
+
+<h2>Classes</h2>
+<ul class="nowrap">
+  <li><strong>pegasus</strong></li>
+  <li><a href="../classes/pegasus.handler.html">pegasus.handler</a></li>
+  <li><a href="../classes/pegasus.plugins.compress.html">pegasus.plugins.compress</a></li>
+  <li><a href="../classes/pegasus.plugins.downloads.html">pegasus.plugins.downloads</a></li>
+  <li><a href="../classes/pegasus.plugins.files.html">pegasus.plugins.files</a></li>
+  <li><a href="../classes/pegasus.plugins.router.html">pegasus.plugins.router</a></li>
+  <li><a href="../classes/pegasus.plugins.tls.html">pegasus.plugins.tls</a></li>
+  <li><a href="../classes/pegasus.request.html">pegasus.request</a></li>
+  <li><a href="../classes/pegasus.response.html">pegasus.response</a></li>
+</ul>
+<h2>Modules</h2>
+<ul class="nowrap">
+  <li><a href="../modules/logging.html">logging</a></li>
+</ul>
+<h2>Topics</h2>
+<ul class="">
+  <li><a href="../topics/LICENSE.html">LICENSE</a></li>
+  <li><a href="../topics/README.md.html">README</a></li>
+</ul>
+<h2>Examples</h2>
+<ul class="nowrap">
+  <li><a href="../examples/app.lua.html">app.lua</a></li>
+  <li><a href="../examples/app_stream.lua.html">app_stream.lua</a></li>
+  <li><a href="../examples/copas.lua.html">copas.lua</a></li>
+  <li><a href="../examples/querystring.lua.html">querystring.lua</a></li>
+  <li><a href="../examples/write.lua.html">write.lua</a></li>
+</ul>
+
+</div>
+
+<div id="content">
+
+<h1>Class <code>pegasus</code></h1>
+<p>The Pegasus server main entry point.</p>
+<p>
+
+
+<p> Minimal, embeddable HTTP server with a simple plugin system.</p>
+
+<p> Notes:</p>
+
+<ul>
+    <li>If <a href="https://keplerproject.github.io/lualogging/">LuaLogging</a> is available, it will be auto-detected and used for logging.</li>
+    <li>Common plugins include <code>files</code>, <code>router</code>, <code>compress</code>, <code>downloads</code>, and <code>tls</code>.</li>
+    <li>See <a href="../classes/pegasus.handler.html#">pegasus.handler</a> for the request/response lifecycle and plugin hooks.</li>
+</ul>
+
+<p> Example:</p>
+
+
+<pre>
+<span class="keyword">local</span> Pegasus = <span class="global">require</span> <span class="string">'pegasus'</span>
+<span class="keyword">local</span> server = Pegasus:<span class="function-name">new</span>{ host = <span class="string">'127.0.0.1'</span>, port = <span class="string">'8080'</span> }
+server:<span class="function-name">start</span>(<span class="keyword">function</span>(request, response)
+  response:<span class="function-name">statusCode</span>(<span class="number">200</span>)
+  response:<span class="function-name">addHeader</span>(<span class="string">'Content-Type'</span>, <span class="string">'text/plain'</span>)
+  response:<span class="function-name">write</span>(<span class="string">'Hello, world!'</span>)
+<span class="keyword">end</span>)
+</pre>
+
+</p>
+
+
+<h2><a href="#Functions">Functions</a></h2>
+<table class="function_list">
+	<tr>
+	<td class="name" nowrap><a href="#Pegasus:new">Pegasus:new ([params])</a></td>
+	<td class="summary">Create a new Pegasus server instance.</td>
+	</tr>
+	<tr>
+	<td class="name" nowrap><a href="#Pegasus:start">Pegasus:start (callback)</a></td>
+	<td class="summary">Start the server accept loop (blocking).</td>
+	</tr>
+</table>
+
+<br/>
+<br/>
+
+
+    <h2 class="section-header "><a name="Functions"></a>Functions</h2>
+    Methods
+    <dl class="function">
+    <dt>
+    <a name = "Pegasus:new"></a>
+    <strong>Pegasus:new ([params])</strong>
+    </dt>
+    <dd>
+    Create a new Pegasus server instance.
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">params</span> configuration table
+        <ul>
+        <li><span class="parameter">host</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
+         bind address
+         (<em>default</em> '*')
+        </li>
+        <li><span class="parameter">port</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a> or <span class="type">number</span></span>
+         bind port
+         (<em>default</em> 9090)
+        </li>
+        <li><span class="parameter">location</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
+         base directory used by some plugins
+         (<em>default</em> "")
+        </li>
+        <li><span class="parameter">plugins</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.6">table</a></span>
+         list of plugins to be applied
+         (<em>default</em> {})
+        </li>
+        <li><span class="parameter">timeout</span>
+            <span class="types"><span class="type">number</span></span>
+         client socket timeout in seconds
+         (<em>default</em> 1)
+        </li>
+        <li><span class="parameter">log</span>
+            <span class="types"><span class="type">logger</span></span>
+         a LuaLogging compatible logger object. Defaults to module <code>pegasus.log</code>.
+         (<em>optional</em>)
+        </li>
+        </li></ul>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+        Pegasus server
+    </ol>
+
+
+
+
+</dd>
+    <dt>
+    <a name = "Pegasus:start"></a>
+    <strong>Pegasus:start (callback)</strong>
+    </dt>
+    <dd>
+    Start the server accept loop (blocking). </p>
+
+<p> Starts the server and handles incoming connections. The provided callback is invoked once per incoming HTTP request.
+ Errors during <code>socket.bind</code> will raise; accept errors are logged and the loop continues.
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">callback</span>
+            <span class="types"><span class="type">function</span></span>
+         using signature <code>stop_further_processing = function(request, response)</code>
+        </li>
+    </ul>
+
+
+    <h3>Raises:</h3>
+    on bind failure
+
+
+    <h3>Usage:</h3>
+    <ul>
+        <pre class="example">server:<span class="function-name">start</span>(<span class="keyword">function</span>(request, response)
+  <span class="comment">-- inspect <code>request</code> (method, path, headers, body, query, etc.)
+</span>  <span class="comment">-- then write a response
+</span>  response:<span class="function-name">statusCode</span>(<span class="number">200</span>)
+  response:<span class="function-name">addHeader</span>(<span class="string">'Content-Type'</span>, <span class="string">'text/plain'</span>)
+  response:<span class="function-name">write</span>(<span class="string">'OK'</span>)
+<span class="keyword">end</span>)</pre>
+    </ul>
+
+</dd>
+</dl>
+
+
+</div> <!-- id="content" -->
+</div> <!-- id="main" -->
+<div id="about">
+<i>generated by <a href="http://github.com/lunarmodules/ldoc">LDoc 1.5.0</a></i>
+<i style="float:right;">Last updated 2026-03-30 13:29:33 </i>
+</div> <!-- id="about" -->
+</div> <!-- id="container" -->
+</body>
+</html>
diff --git a/docs/classes/pegasus.plugins.compress.html b/docs/classes/pegasus.plugins.compress.html
new file mode 100644
index 0000000..71c6ce7
--- /dev/null
+++ b/docs/classes/pegasus.plugins.compress.html
@@ -0,0 +1,210 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+<head>
+    <title>Pegasus webserver in Lua</title>
+    <link rel="stylesheet" href="../ldoc.css" type="text/css" />
+</head>
+<body>
+
+<div id="container">
+
+<div id="product">
+	<div id="product_logo"></div>
+	<div id="product_name"><big><b></b></big></div>
+	<div id="product_description"></div>
+</div> <!-- id="product" -->
+
+
+<div id="main">
+
+
+<!-- Menu -->
+
+<div id="navigation">
+<br/>
+<h1>Pegasus</h1>
+
+
+<ul>
+  <li><a href="../index.html">Index</a></li>
+</ul>
+
+<h2>Contents</h2>
+<ul>
+<li><a href="#Functions">Functions</a></li>
+</ul>
+
+
+<h2>Classes</h2>
+<ul class="nowrap">
+  <li><a href="../classes/pegasus.html">pegasus</a></li>
+  <li><a href="../classes/pegasus.handler.html">pegasus.handler</a></li>
+  <li><strong>pegasus.plugins.compress</strong></li>
+  <li><a href="../classes/pegasus.plugins.downloads.html">pegasus.plugins.downloads</a></li>
+  <li><a href="../classes/pegasus.plugins.files.html">pegasus.plugins.files</a></li>
+  <li><a href="../classes/pegasus.plugins.router.html">pegasus.plugins.router</a></li>
+  <li><a href="../classes/pegasus.plugins.tls.html">pegasus.plugins.tls</a></li>
+  <li><a href="../classes/pegasus.request.html">pegasus.request</a></li>
+  <li><a href="../classes/pegasus.response.html">pegasus.response</a></li>
+</ul>
+<h2>Modules</h2>
+<ul class="nowrap">
+  <li><a href="../modules/logging.html">logging</a></li>
+</ul>
+<h2>Topics</h2>
+<ul class="">
+  <li><a href="../topics/LICENSE.html">LICENSE</a></li>
+  <li><a href="../topics/README.md.html">README</a></li>
+</ul>
+<h2>Examples</h2>
+<ul class="nowrap">
+  <li><a href="../examples/app.lua.html">app.lua</a></li>
+  <li><a href="../examples/app_stream.lua.html">app_stream.lua</a></li>
+  <li><a href="../examples/copas.lua.html">copas.lua</a></li>
+  <li><a href="../examples/querystring.lua.html">querystring.lua</a></li>
+  <li><a href="../examples/write.lua.html">write.lua</a></li>
+</ul>
+
+</div>
+
+<div id="content">
+
+<h1>Class <code>pegasus.plugins.compress</code></h1>
+<p>gzip compression for responses.</p>
+<p>
+
+
+<p> Response body compressor that applies gzip when the client accepts it
+ and compression is beneficial. Works with both <code>lua-zlib</code> and <code>lzlib</code>.</p>
+
+<p> Behavior:</p>
+
+<ul>
+    <li>Detects <code>Accept-Encoding: gzip</code> on the request (or <code>Content-Encoding</code> already set)</li>
+    <li>Sets <code>Content-Encoding: gzip</code> when compressing</li>
+    <li>Supports streaming with chunked encoding; maintains an internal zlib stream</li>
+    <li>Leaves content unchanged when compression does not reduce size</li>
+</ul>
+
+<p> Levels:</p>
+
+<ul>
+    <li><code>plugin.NO_COMPRESSION</code> (0): no compression</li>
+    <li><code>plugin.BEST_SPEED</code> (1): fastest compression</li>
+    <li><code>plugin.BEST_COMPRESSION</code> (9): best compression ratio</li>
+    <li><code>plugin.DEFAULT_COMPRESSION</code> (-1): zlib default</li>
+</ul>
+</p>
+
+
+<h2><a href="#Functions">Functions</a></h2>
+<table class="function_list">
+	<tr>
+	<td class="name" nowrap><a href="#Compress:new">Compress:new ([options])</a></td>
+	<td class="summary">Create a new <code>Compress</code> plugin instance.</td>
+	</tr>
+	<tr>
+	<td class="name" nowrap><a href="#Compress:processBodyData">Compress:processBodyData (data, stayOpen, request, response)</a></td>
+	<td class="summary">Compress response body data when appropriate.</td>
+	</tr>
+</table>
+
+<br/>
+<br/>
+
+
+    <h2 class="section-header "><a name="Functions"></a>Functions</h2>
+    Methods
+    <dl class="function">
+    <dt>
+    <a name = "Compress:new"></a>
+    <strong>Compress:new ([options])</strong>
+    </dt>
+    <dd>
+    Create a new <code>Compress</code> plugin instance.
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">options</span>
+
+
+        <ul>
+        <li><span class="parameter">level</span>
+            <span class="types"><span class="type">number</span></span>
+         zlib compression level (see constants above)
+         (<em>default</em> plugin.DEFAULT_COMPRESSION)
+        </li>
+        </li></ul>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+        plugin instance
+    </ol>
+
+
+
+
+</dd>
+    <dt>
+    <a name = "Compress:processBodyData"></a>
+    <strong>Compress:processBodyData (data, stayOpen, request, response)</strong>
+    </dt>
+    <dd>
+    Compress response body data when appropriate. </p>
+
+<p> Invoked for every body chunk. When <code>stayOpen</code> is true, keeps an internal
+ zlib stream and returns the compressed chunk. On the final call with
+ <code>data == nil</code>, closes the stream and returns any trailer bytes.</p>
+
+<p> If compression does not reduce size (for non-streaming case), the
+ original <code>data</code> is returned and no <code>Content-Encoding</code> header is set.
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">data</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a> or <span class="type">nil</span></span>
+         body chunk, or <code>nil</code> to finish streaming
+        </li>
+        <li><span class="parameter">stayOpen</span>
+            <span class="types"><span class="type">boolean</span></span>
+         whether the response is streaming (chunked)
+        </li>
+        <li><span class="parameter">request</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.6">table</a></span>
+         request object
+        </li>
+        <li><span class="parameter">response</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.6">table</a></span>
+         response object
+        </li>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+           <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
+        data possibly compressed
+    </ol>
+
+
+
+
+</dd>
+</dl>
+
+
+</div> <!-- id="content" -->
+</div> <!-- id="main" -->
+<div id="about">
+<i>generated by <a href="http://github.com/lunarmodules/ldoc">LDoc 1.5.0</a></i>
+<i style="float:right;">Last updated 2026-03-30 13:29:33 </i>
+</div> <!-- id="about" -->
+</div> <!-- id="container" -->
+</body>
+</html>
diff --git a/docs/classes/pegasus.plugins.downloads.html b/docs/classes/pegasus.plugins.downloads.html
new file mode 100644
index 0000000..18dd67b
--- /dev/null
+++ b/docs/classes/pegasus.plugins.downloads.html
@@ -0,0 +1,207 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+<head>
+    <title>Pegasus webserver in Lua</title>
+    <link rel="stylesheet" href="../ldoc.css" type="text/css" />
+</head>
+<body>
+
+<div id="container">
+
+<div id="product">
+	<div id="product_logo"></div>
+	<div id="product_name"><big><b></b></big></div>
+	<div id="product_description"></div>
+</div> <!-- id="product" -->
+
+
+<div id="main">
+
+
+<!-- Menu -->
+
+<div id="navigation">
+<br/>
+<h1>Pegasus</h1>
+
+
+<ul>
+  <li><a href="../index.html">Index</a></li>
+</ul>
+
+<h2>Contents</h2>
+<ul>
+<li><a href="#Functions">Functions</a></li>
+</ul>
+
+
+<h2>Classes</h2>
+<ul class="nowrap">
+  <li><a href="../classes/pegasus.html">pegasus</a></li>
+  <li><a href="../classes/pegasus.handler.html">pegasus.handler</a></li>
+  <li><a href="../classes/pegasus.plugins.compress.html">pegasus.plugins.compress</a></li>
+  <li><strong>pegasus.plugins.downloads</strong></li>
+  <li><a href="../classes/pegasus.plugins.files.html">pegasus.plugins.files</a></li>
+  <li><a href="../classes/pegasus.plugins.router.html">pegasus.plugins.router</a></li>
+  <li><a href="../classes/pegasus.plugins.tls.html">pegasus.plugins.tls</a></li>
+  <li><a href="../classes/pegasus.request.html">pegasus.request</a></li>
+  <li><a href="../classes/pegasus.response.html">pegasus.response</a></li>
+</ul>
+<h2>Modules</h2>
+<ul class="nowrap">
+  <li><a href="../modules/logging.html">logging</a></li>
+</ul>
+<h2>Topics</h2>
+<ul class="">
+  <li><a href="../topics/LICENSE.html">LICENSE</a></li>
+  <li><a href="../topics/README.md.html">README</a></li>
+</ul>
+<h2>Examples</h2>
+<ul class="nowrap">
+  <li><a href="../examples/app.lua.html">app.lua</a></li>
+  <li><a href="../examples/app_stream.lua.html">app_stream.lua</a></li>
+  <li><a href="../examples/copas.lua.html">copas.lua</a></li>
+  <li><a href="../examples/querystring.lua.html">querystring.lua</a></li>
+  <li><a href="../examples/write.lua.html">write.lua</a></li>
+</ul>
+
+</div>
+
+<div id="content">
+
+<h1>Class <code>pegasus.plugins.downloads</code></h1>
+<p>Plugin that sends files downstream as downloads.</p>
+<p>
+
+
+<p> A plugin that exposes a virtual directory for file downloads. Matches
+ a configurable <code>prefix</code> and serves files from a configured <code>location</code>
+ using <code>Content-Disposition: attachment</code>.</p>
+
+<p> The plugin only responds to <code>GET</code> and <code>HEAD</code>.</p>
+
+<p> Example:</p>
+
+
+<pre>
+<span class="keyword">local</span> Downloads = <span class="global">require</span>(<span class="string">'pegasus.plugins.downloads'</span>)
+<span class="keyword">local</span> plugin = Downloads:<span class="function-name">new</span>{ location = <span class="string">'./public'</span>, prefix = <span class="string">'downloads'</span> }
+<span class="comment">-- Add plugin to Pegasus</span>
+</pre>
+
+</p>
+
+
+<h2><a href="#Functions">Functions</a></h2>
+<table class="function_list">
+	<tr>
+	<td class="name" nowrap><a href="#Downloads:new">Downloads:new (options)</a></td>
+	<td class="summary">Creates a new plugin instance.</td>
+	</tr>
+	<tr>
+	<td class="name" nowrap><a href="#Downloads:newRequestResponse">Downloads:newRequestResponse (request, response)</a></td>
+	<td class="summary">Handle a new request/response pair; serve a download when the path matches.</td>
+	</tr>
+</table>
+
+<br/>
+<br/>
+
+
+    <h2 class="section-header "><a name="Functions"></a>Functions</h2>
+    Methods
+    <dl class="function">
+    <dt>
+    <a name = "Downloads:new"></a>
+    <strong>Downloads:new (options)</strong>
+    </dt>
+    <dd>
+    Creates a new plugin instance.
+ The plugin will only respond to <code>GET</code> requests. The files will be served from the
+ same <code>location</code> setting as defined in the <code>Handler</code>. The <code>prefix</code> is a virtual folder
+ that triggers the plugin, but will be removed from the filepath if <code>stripPrefix</code> is truthy.
+ If <code>stripPrefix</code> is falsy, then it should be a real folder.
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">options</span> the options table with the following fields;
+        <ul>
+        <li><span class="parameter">location</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
+         the path to serve files from. Relative to the working directory.
+         (<em>default</em> "./")
+        </li>
+        <li><span class="parameter">prefix</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
+         the path prefix that triggers the plugin
+         (<em>default</em> "downloads/")
+        </li>
+        <li><span class="parameter">stripPrefix</span>
+            <span class="types"><span class="type">bool</span></span>
+         whether to strip the prefix from the file path when looking
+ for the file in the filesystem. Defaults to <code>false</code>, unless <code>options.prefix</code> is omitted,
+ then it defaults to <code>true</code>.
+        </li>
+        </li></ul>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+        the new plugin
+    </ol>
+
+
+
+
+</dd>
+    <dt>
+    <a name = "Downloads:newRequestResponse"></a>
+    <strong>Downloads:newRequestResponse (request, response)</strong>
+    </dt>
+    <dd>
+    Handle a new request/response pair; serve a download when the path matches.
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">request</span>
+            <span class="types"><a class="type" href="../classes/pegasus.request.html#">pegasus.request</a></span>
+
+
+
+        </li>
+        <li><span class="parameter">response</span>
+            <span class="types"><a class="type" href="../classes/pegasus.response.html#">pegasus.response</a></span>
+
+
+
+        </li>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+           <span class="types"><span class="type">boolean</span></span>
+        stop returns true if the plugin found and wrote the file to the response.
+    </ol>
+
+
+
+
+</dd>
+</dl>
+
+
+</div> <!-- id="content" -->
+</div> <!-- id="main" -->
+<div id="about">
+<i>generated by <a href="http://github.com/lunarmodules/ldoc">LDoc 1.5.0</a></i>
+<i style="float:right;">Last updated 2026-03-30 13:29:33 </i>
+</div> <!-- id="about" -->
+</div> <!-- id="container" -->
+</body>
+</html>
diff --git a/docs/classes/pegasus.plugins.files.html b/docs/classes/pegasus.plugins.files.html
new file mode 100644
index 0000000..4129fb2
--- /dev/null
+++ b/docs/classes/pegasus.plugins.files.html
@@ -0,0 +1,183 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+<head>
+    <title>Pegasus webserver in Lua</title>
+    <link rel="stylesheet" href="../ldoc.css" type="text/css" />
+</head>
+<body>
+
+<div id="container">
+
+<div id="product">
+	<div id="product_logo"></div>
+	<div id="product_name"><big><b></b></big></div>
+	<div id="product_description"></div>
+</div> <!-- id="product" -->
+
+
+<div id="main">
+
+
+<!-- Menu -->
+
+<div id="navigation">
+<br/>
+<h1>Pegasus</h1>
+
+
+<ul>
+  <li><a href="../index.html">Index</a></li>
+</ul>
+
+<h2>Contents</h2>
+<ul>
+<li><a href="#Functions">Functions</a></li>
+</ul>
+
+
+<h2>Classes</h2>
+<ul class="nowrap">
+  <li><a href="../classes/pegasus.html">pegasus</a></li>
+  <li><a href="../classes/pegasus.handler.html">pegasus.handler</a></li>
+  <li><a href="../classes/pegasus.plugins.compress.html">pegasus.plugins.compress</a></li>
+  <li><a href="../classes/pegasus.plugins.downloads.html">pegasus.plugins.downloads</a></li>
+  <li><strong>pegasus.plugins.files</strong></li>
+  <li><a href="../classes/pegasus.plugins.router.html">pegasus.plugins.router</a></li>
+  <li><a href="../classes/pegasus.plugins.tls.html">pegasus.plugins.tls</a></li>
+  <li><a href="../classes/pegasus.request.html">pegasus.request</a></li>
+  <li><a href="../classes/pegasus.response.html">pegasus.response</a></li>
+</ul>
+<h2>Modules</h2>
+<ul class="nowrap">
+  <li><a href="../modules/logging.html">logging</a></li>
+</ul>
+<h2>Topics</h2>
+<ul class="">
+  <li><a href="../topics/LICENSE.html">LICENSE</a></li>
+  <li><a href="../topics/README.md.html">README</a></li>
+</ul>
+<h2>Examples</h2>
+<ul class="nowrap">
+  <li><a href="../examples/app.lua.html">app.lua</a></li>
+  <li><a href="../examples/app_stream.lua.html">app_stream.lua</a></li>
+  <li><a href="../examples/copas.lua.html">copas.lua</a></li>
+  <li><a href="../examples/querystring.lua.html">querystring.lua</a></li>
+  <li><a href="../examples/write.lua.html">write.lua</a></li>
+</ul>
+
+</div>
+
+<div id="content">
+
+<h1>Class <code>pegasus.plugins.files</code></h1>
+<p>Plugin that serves static content.</p>
+<p> A plugin that serves static content from a folder and optionally redirects
+ <code>&quot;/&quot;</code> to a configured default file.</p>
+
+
+<h2><a href="#Functions">Functions</a></h2>
+<table class="function_list">
+	<tr>
+	<td class="name" nowrap><a href="#Files:new">Files:new (options)</a></td>
+	<td class="summary">Creates a new plugin instance.</td>
+	</tr>
+	<tr>
+	<td class="name" nowrap><a href="#Files:newRequestResponse">Files:newRequestResponse (request, response)</a></td>
+	<td class="summary">Handle a new request/response pair; serve static files.</td>
+	</tr>
+</table>
+
+<br/>
+<br/>
+
+
+    <h2 class="section-header "><a name="Functions"></a>Functions</h2>
+    Methods
+    <dl class="function">
+    <dt>
+    <a name = "Files:new"></a>
+    <strong>Files:new (options)</strong>
+    </dt>
+    <dd>
+    Creates a new plugin instance.
+ The plugin will only respond to <code>GET</code> requests. The files will be served from the
+ <code>location</code> folder.
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">options</span> the options table with the following fields;
+        <ul>
+        <li><span class="parameter">location</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
+         the path to serve files from. Relative to the working directory.
+         (<em>default</em> "./")
+        </li>
+        <li><span class="parameter">default</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
+         filename to serve for top-level without path. Use an empty
+ string to have none.
+         (<em>default</em> "index.html")
+        </li>
+        </li></ul>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+        the new plugin
+    </ol>
+
+
+
+
+</dd>
+    <dt>
+    <a name = "Files:newRequestResponse"></a>
+    <strong>Files:newRequestResponse (request, response)</strong>
+    </dt>
+    <dd>
+    Handle a new request/response pair; serve static files.
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">request</span>
+            <span class="types"><a class="type" href="../classes/pegasus.request.html#">pegasus.request</a></span>
+
+
+
+        </li>
+        <li><span class="parameter">response</span>
+            <span class="types"><a class="type" href="../classes/pegasus.response.html#">pegasus.response</a></span>
+
+
+
+        </li>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+           <span class="types"><span class="type">boolean</span></span>
+        stop returns true if the plugin found and wrote the file to the response.
+    </ol>
+
+
+
+
+</dd>
+</dl>
+
+
+</div> <!-- id="content" -->
+</div> <!-- id="main" -->
+<div id="about">
+<i>generated by <a href="http://github.com/lunarmodules/ldoc">LDoc 1.5.0</a></i>
+<i style="float:right;">Last updated 2026-03-30 13:29:33 </i>
+</div> <!-- id="about" -->
+</div> <!-- id="container" -->
+</body>
+</html>
diff --git a/docs/classes/pegasus.plugins.router.html b/docs/classes/pegasus.plugins.router.html
new file mode 100644
index 0000000..d06721c
--- /dev/null
+++ b/docs/classes/pegasus.plugins.router.html
@@ -0,0 +1,307 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+<head>
+    <title>Pegasus webserver in Lua</title>
+    <link rel="stylesheet" href="../ldoc.css" type="text/css" />
+</head>
+<body>
+
+<div id="container">
+
+<div id="product">
+	<div id="product_logo"></div>
+	<div id="product_name"><big><b></b></big></div>
+	<div id="product_description"></div>
+</div> <!-- id="product" -->
+
+
+<div id="main">
+
+
+<!-- Menu -->
+
+<div id="navigation">
+<br/>
+<h1>Pegasus</h1>
+
+
+<ul>
+  <li><a href="../index.html">Index</a></li>
+</ul>
+
+<h2>Contents</h2>
+<ul>
+<li><a href="#Functions">Functions</a></li>
+</ul>
+
+
+<h2>Classes</h2>
+<ul class="nowrap">
+  <li><a href="../classes/pegasus.html">pegasus</a></li>
+  <li><a href="../classes/pegasus.handler.html">pegasus.handler</a></li>
+  <li><a href="../classes/pegasus.plugins.compress.html">pegasus.plugins.compress</a></li>
+  <li><a href="../classes/pegasus.plugins.downloads.html">pegasus.plugins.downloads</a></li>
+  <li><a href="../classes/pegasus.plugins.files.html">pegasus.plugins.files</a></li>
+  <li><strong>pegasus.plugins.router</strong></li>
+  <li><a href="../classes/pegasus.plugins.tls.html">pegasus.plugins.tls</a></li>
+  <li><a href="../classes/pegasus.request.html">pegasus.request</a></li>
+  <li><a href="../classes/pegasus.response.html">pegasus.response</a></li>
+</ul>
+<h2>Modules</h2>
+<ul class="nowrap">
+  <li><a href="../modules/logging.html">logging</a></li>
+</ul>
+<h2>Topics</h2>
+<ul class="">
+  <li><a href="../topics/LICENSE.html">LICENSE</a></li>
+  <li><a href="../topics/README.md.html">README</a></li>
+</ul>
+<h2>Examples</h2>
+<ul class="nowrap">
+  <li><a href="../examples/app.lua.html">app.lua</a></li>
+  <li><a href="../examples/app_stream.lua.html">app_stream.lua</a></li>
+  <li><a href="../examples/copas.lua.html">copas.lua</a></li>
+  <li><a href="../examples/querystring.lua.html">querystring.lua</a></li>
+  <li><a href="../examples/write.lua.html">write.lua</a></li>
+</ul>
+
+</div>
+
+<div id="content">
+
+<h1>Class <code>pegasus.plugins.router</code></h1>
+<p>A router plugin for handling paths/methods/path-parameters.</p>
+<p>
+
+
+<p> A plugin that routes requests based on path and method, with support for
+ path parameters and pre/post hooks at both router and path levels.</p>
+
+<p> Supports path parameters.</p>
+
+<p> The <code>routes</code> table to configure the router is a hash-table where the keys are the path, and
+ the value is another hash-table. The second hash-table has the method as the key, and the
+ callbacks as the values.
+ Both hash-tables can have "<code>preFunction</code>" and "<code>postFunction</code>" entries,
+ which should have callbacks as values.</p>
+
+<p> There are 5 callbacks (called in this order);</p>
+
+<ul>
+    <li><p>the router <code>preFunction</code> callback is called first when there is a <code>prefix</code> match. It can
+    be used to do some validations, like path parameters, etc. It is defined on <a href="../classes/pegasus.plugins.router.html">router</a> level.</p></li>
+    <li><p>the path <code>preFunction</code> callback is called when there is a <code>path</code> match. It can
+    be used to do some validations, like path parameters, etc. It is defined on <code>path</code> level.</p></li>
+    <li><p>the <code>METHOD</code> (eg. <code>GET</code>, <code>POST</code>, etc) this callback implements the specific method. It is defined
+    once for each supported method on the path. The special case is method "<code>*</code>" which is a catch-all.
+    The catch-all will be used for any method that doesn't have its own handler defined.
+    If omitted, the default catch-all will return a "405 Method Not Allowed" error.</p></li>
+    <li><p>the path <code>postFunction</code> is called after the <code>METHOD</code> callback. This one is defined on <code>path</code> level.</p></li>
+    <li><p>the router <code>postFunction</code> is called last. This one is defined on <a href="../classes/pegasus.plugins.router.html">router</a> level.</p></li>
+</ul>
+
+<p> The callbacks have the following function signature; <code>stop = function(request, response)</code>.
+ If <code>stop</code> is truthy, request handling is terminated, no further callbacks will be called.</p>
+
+<p> Path parameters can be defined in the path in curly braces; "<code>{variableName}</code>", and they will match
+ a single path segment. The values will be made available on the Request object as
+ <code>request.pathParameters.variableName</code>.</p>
+
+<p> The API sub-path (without the prefix) is available as on the Request object as <code>request.routerPath</code>.</p>
+
+<p> Route matching is based on a complete match (not prefix). And the order is based on the number
+ of path-parameters defined. Least number of parameters go first, such that static paths have
+ precedence over variables.</p>
+
+<p> Example:</p>
+
+
+<pre>
+<span class="keyword">local</span> routes = {
+  preFunction = <span class="keyword">function</span>(req, resp)
+    <span class="keyword">local</span> stop = <span class="keyword">false</span>
+    <span class="comment">-- this gets called before any path specific callback
+</span>
+    <span class="keyword">if</span> some_error <span class="keyword">then</span>
+      resp:<span class="function-name">writeDefaultErrorMessage</span>(<span class="number">400</span>)
+      stop = <span class="keyword">true</span>
+    <span class="keyword">end</span>
+    <span class="keyword">return</span> stop
+  <span class="keyword">end</span>,
+
+
+  [<span class="string">"/my/{accountNumber}/{param2}/endpoint"</span>] = { <span class="comment">-- define path parameters
+</span>
+    preFunction = <span class="keyword">function</span>(req, resp)
+      <span class="keyword">local</span> stop = <span class="keyword">false</span>
+      <span class="comment">-- this gets called before any method specific callback,
+</span>      <span class="comment">-- but after the router-preFunction
+</span>      <span class="keyword">return</span> stop
+    <span class="keyword">end</span>,
+
+    GET = <span class="keyword">function</span>(req, resp)
+      <span class="keyword">local</span> stop = <span class="keyword">false</span>
+      <span class="comment">-- this implements the main GET logic
+</span>      <span class="keyword">return</span> stop
+    <span class="keyword">end</span>,
+
+    POST = <span class="keyword">function</span>(req, resp)
+      <span class="keyword">local</span> stop = <span class="keyword">false</span>
+      <span class="comment">-- this implements the main POST logic
+</span>      <span class="keyword">return</span> stop
+    <span class="keyword">end</span>,
+
+    [<span class="string">"*"</span>] = <span class="keyword">function</span>(req, resp)
+      <span class="keyword">local</span> stop = <span class="keyword">false</span>
+      <span class="comment">-- this implements the wildcard, will handle any method except for the
+</span>      <span class="comment">-- GET/POST ones defined above.
+</span>
+      <span class="comment">-- If the wildcard is not defined, then a default one will be added which
+</span>      <span class="comment">-- only returns a "405 Method Not Allowed" error.
+</span>      <span class="keyword">return</span> stop
+    <span class="keyword">end</span>,
+
+    postFunction = <span class="keyword">function</span>(req, resp)
+      <span class="keyword">local</span> stop = <span class="keyword">false</span>
+      <span class="comment">-- this gets called after the method specific (or wildcard)
+</span>      <span class="comment">-- callback.
+</span>
+      <span class="keyword">return</span> stop
+    <span class="keyword">end</span>,
+  },
+
+  [<span class="string">"/my/endpoint"</span>] = <span class="keyword">function</span>(req, resp)
+    <span class="keyword">local</span> stop = <span class="keyword">false</span>
+    <span class="comment">-- this is a shortcut to create a wildcard-method, one callback
+</span>    <span class="comment">-- to handle any method for this path. Identical to:
+</span>    <span class="comment">-- ["/my/endpoint"] = { ["*"] = function(req, resp) ... end }
+</span>    <span class="keyword">return</span> stop
+  <span class="keyword">end</span>,
+
+  postFunction = <span class="keyword">function</span>(req, resp)
+    <span class="keyword">local</span> stop = <span class="keyword">false</span>
+    <span class="comment">-- this gets called last.
+</span>    <span class="keyword">return</span> stop
+  <span class="keyword">end</span>,
+}
+
+<span class="keyword">local</span> router = Router:<span class="function-name">new</span> {
+  prefix = <span class="string">"/api/1v0/"</span>,
+  routes = routes,
+}
+</pre>
+
+</p>
+
+
+<h2><a href="#Functions">Functions</a></h2>
+<table class="function_list">
+	<tr>
+	<td class="name" nowrap><a href="#Router:new">Router:new (options)</a></td>
+	<td class="summary">Creates a new Router plugin instance.</td>
+	</tr>
+	<tr>
+	<td class="name" nowrap><a href="#Router:newRequestResponse">Router:newRequestResponse (request, response)</a></td>
+	<td class="summary">Route the request to the matching path/method callback.</td>
+	</tr>
+</table>
+
+<br/>
+<br/>
+
+
+    <h2 class="section-header "><a name="Functions"></a>Functions</h2>
+    Methods
+    <dl class="function">
+    <dt>
+    <a name = "Router:new"></a>
+    <strong>Router:new (options)</strong>
+    </dt>
+    <dd>
+    Creates a new Router plugin instance.
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">options</span> the options table with the following fields;
+        <ul>
+        <li><span class="parameter">prefix</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
+         the base path for all underlying routes.
+         (<em>optional</em>)
+        </li>
+        <li><span class="parameter">routes</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.6">table</a></span>
+         route definitions to be handled by this router plugin instance.
+        </li>
+        <li><span class="parameter">errorHandler</span>
+            <span class="types"><span class="type">function</span></span>
+         an optional error handler function with signature
+ <code>message_to_log = function(request, response, errobj)</code>. The default handler will send a 500 error
+ response, and return a stack trace for logging.
+         (<em>optional</em>)
+        </li>
+        </li></ul>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+        the new plugin
+    </ol>
+
+
+
+
+</dd>
+    <dt>
+    <a name = "Router:newRequestResponse"></a>
+    <strong>Router:newRequestResponse (request, response)</strong>
+    </dt>
+    <dd>
+    Route the request to the matching path/method callback.
+ Populates <code>request.pathParameters</code> and <code>request.routerPath</code> upon match.
+ Executes callbacks in order: router pre, path pre, method, path post, router post.
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">request</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.6">table</a></span>
+
+
+
+        </li>
+        <li><span class="parameter">response</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.6">table</a></span>
+
+
+
+        </li>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+           <span class="types"><span class="type">boolean</span></span>
+        stop whether request handling should stop
+    </ol>
+
+
+
+
+</dd>
+</dl>
+
+
+</div> <!-- id="content" -->
+</div> <!-- id="main" -->
+<div id="about">
+<i>generated by <a href="http://github.com/lunarmodules/ldoc">LDoc 1.5.0</a></i>
+<i style="float:right;">Last updated 2026-03-30 13:29:33 </i>
+</div> <!-- id="about" -->
+</div> <!-- id="container" -->
+</body>
+</html>
diff --git a/docs/classes/pegasus.plugins.tls.html b/docs/classes/pegasus.plugins.tls.html
new file mode 100644
index 0000000..944f0c5
--- /dev/null
+++ b/docs/classes/pegasus.plugins.tls.html
@@ -0,0 +1,186 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+<head>
+    <title>Pegasus webserver in Lua</title>
+    <link rel="stylesheet" href="../ldoc.css" type="text/css" />
+</head>
+<body>
+
+<div id="container">
+
+<div id="product">
+	<div id="product_logo"></div>
+	<div id="product_name"><big><b></b></big></div>
+	<div id="product_description"></div>
+</div> <!-- id="product" -->
+
+
+<div id="main">
+
+
+<!-- Menu -->
+
+<div id="navigation">
+<br/>
+<h1>Pegasus</h1>
+
+
+<ul>
+  <li><a href="../index.html">Index</a></li>
+</ul>
+
+<h2>Contents</h2>
+<ul>
+<li><a href="#Functions">Functions</a></li>
+</ul>
+
+
+<h2>Classes</h2>
+<ul class="nowrap">
+  <li><a href="../classes/pegasus.html">pegasus</a></li>
+  <li><a href="../classes/pegasus.handler.html">pegasus.handler</a></li>
+  <li><a href="../classes/pegasus.plugins.compress.html">pegasus.plugins.compress</a></li>
+  <li><a href="../classes/pegasus.plugins.downloads.html">pegasus.plugins.downloads</a></li>
+  <li><a href="../classes/pegasus.plugins.files.html">pegasus.plugins.files</a></li>
+  <li><a href="../classes/pegasus.plugins.router.html">pegasus.plugins.router</a></li>
+  <li><strong>pegasus.plugins.tls</strong></li>
+  <li><a href="../classes/pegasus.request.html">pegasus.request</a></li>
+  <li><a href="../classes/pegasus.response.html">pegasus.response</a></li>
+</ul>
+<h2>Modules</h2>
+<ul class="nowrap">
+  <li><a href="../modules/logging.html">logging</a></li>
+</ul>
+<h2>Topics</h2>
+<ul class="">
+  <li><a href="../topics/LICENSE.html">LICENSE</a></li>
+  <li><a href="../topics/README.md.html">README</a></li>
+</ul>
+<h2>Examples</h2>
+<ul class="nowrap">
+  <li><a href="../examples/app.lua.html">app.lua</a></li>
+  <li><a href="../examples/app_stream.lua.html">app_stream.lua</a></li>
+  <li><a href="../examples/copas.lua.html">copas.lua</a></li>
+  <li><a href="../examples/querystring.lua.html">querystring.lua</a></li>
+  <li><a href="../examples/write.lua.html">write.lua</a></li>
+</ul>
+
+</div>
+
+<div id="content">
+
+<h1>Class <code>pegasus.plugins.tls</code></h1>
+<p>Implements TLS for secure connections.</p>
+<p> A plugin that enables TLS (https) for connections using LuaSec.
+ Should be the first plugin, since it wraps the client socket and performs
+ the TLS handshake before any other plugin or handler accesses the socket.</p>
+
+<p> This plugin should not be used with Copas. Since Copas has native TLS support
+ and can handle simultaneous <code>http</code> and <code>https</code> connections. See the Copas example
+ to learn how to set that up.</p>
+
+
+<h2><a href="#Functions">Functions</a></h2>
+<table class="function_list">
+	<tr>
+	<td class="name" nowrap><a href="#TLS:new">TLS:new (sslparams)</a></td>
+	<td class="summary">Creates a new plugin instance.</td>
+	</tr>
+	<tr>
+	<td class="name" nowrap><a href="#TLS:newConnection">TLS:newConnection (client, handler)</a></td>
+	<td class="summary">Wrap an accepted client socket and perform the TLS handshake.</td>
+	</tr>
+</table>
+
+<br/>
+<br/>
+
+
+    <h2 class="section-header "><a name="Functions"></a>Functions</h2>
+    Methods
+    <dl class="function">
+    <dt>
+    <a name = "TLS:new"></a>
+    <strong>TLS:new (sslparams)</strong>
+    </dt>
+    <dd>
+    Creates a new plugin instance.
+ IMPORTANT: this must be the first plugin to execute before the client-socket is accessed!
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">sslparams</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.6">table</a></span>
+         the data-structure that contains the properties for the luasec functions.
+ The structure is set up to mimic the LuaSec functions for the handshake.
+        </li>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+        the new plugin
+    </ol>
+
+
+
+    <h3>Usage:</h3>
+    <ul>
+        <pre class="example"><span class="keyword">local</span> sslparams = {
+  wrap = <span class="global">table</span> | context,    <span class="comment">-- parameter to LuaSec 'wrap()'
+</span>  sni = {                    <span class="comment">-- parameters to LuaSec 'sni()'
+</span>    names = <span class="global">string</span> | <span class="global">table</span>   <span class="comment">--   1st parameter
+</span>    strict = bool            <span class="comment">--   2nd parameter
+</span>  }
+}
+<span class="keyword">local</span> tls_plugin = <span class="global">require</span>(<span class="string">"pegasus.plugins.tls"</span>):<span class="function-name">new</span>(sslparams)</pre>
+    </ul>
+
+</dd>
+    <dt>
+    <a name = "TLS:newConnection"></a>
+    <strong>TLS:newConnection (client, handler)</strong>
+    </dt>
+    <dd>
+    Wrap an accepted client socket and perform the TLS handshake.
+ Optionally sets SNI if provided in <code>sslparams</code>.
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">client</span>
+            <span class="types"><span class="type">socket</span></span>
+         accepted client socket
+        </li>
+        <li><span class="parameter">handler</span>
+            <span class="types"><a class="type" href="../classes/pegasus.handler.html#">pegasus.handler</a></span>
+         the Pegasus handler (for logging)
+        </li>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+           <span class="types"><span class="type">socket</span> or <span class="type">false</span></span>
+        wrapped client socket or <code>false</code> on failure
+    </ol>
+
+
+
+
+</dd>
+</dl>
+
+
+</div> <!-- id="content" -->
+</div> <!-- id="main" -->
+<div id="about">
+<i>generated by <a href="http://github.com/lunarmodules/ldoc">LDoc 1.5.0</a></i>
+<i style="float:right;">Last updated 2026-03-30 13:29:33 </i>
+</div> <!-- id="about" -->
+</div> <!-- id="container" -->
+</body>
+</html>
diff --git a/docs/classes/pegasus.request.html b/docs/classes/pegasus.request.html
new file mode 100644
index 0000000..b7c3de3
--- /dev/null
+++ b/docs/classes/pegasus.request.html
@@ -0,0 +1,333 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+<head>
+    <title>Pegasus webserver in Lua</title>
+    <link rel="stylesheet" href="../ldoc.css" type="text/css" />
+</head>
+<body>
+
+<div id="container">
+
+<div id="product">
+	<div id="product_logo"></div>
+	<div id="product_name"><big><b></b></big></div>
+	<div id="product_description"></div>
+</div> <!-- id="product" -->
+
+
+<div id="main">
+
+
+<!-- Menu -->
+
+<div id="navigation">
+<br/>
+<h1>Pegasus</h1>
+
+
+<ul>
+  <li><a href="../index.html">Index</a></li>
+</ul>
+
+<h2>Contents</h2>
+<ul>
+<li><a href="#Functions">Functions</a></li>
+</ul>
+
+
+<h2>Classes</h2>
+<ul class="nowrap">
+  <li><a href="../classes/pegasus.html">pegasus</a></li>
+  <li><a href="../classes/pegasus.handler.html">pegasus.handler</a></li>
+  <li><a href="../classes/pegasus.plugins.compress.html">pegasus.plugins.compress</a></li>
+  <li><a href="../classes/pegasus.plugins.downloads.html">pegasus.plugins.downloads</a></li>
+  <li><a href="../classes/pegasus.plugins.files.html">pegasus.plugins.files</a></li>
+  <li><a href="../classes/pegasus.plugins.router.html">pegasus.plugins.router</a></li>
+  <li><a href="../classes/pegasus.plugins.tls.html">pegasus.plugins.tls</a></li>
+  <li><strong>pegasus.request</strong></li>
+  <li><a href="../classes/pegasus.response.html">pegasus.response</a></li>
+</ul>
+<h2>Modules</h2>
+<ul class="nowrap">
+  <li><a href="../modules/logging.html">logging</a></li>
+</ul>
+<h2>Topics</h2>
+<ul class="">
+  <li><a href="../topics/LICENSE.html">LICENSE</a></li>
+  <li><a href="../topics/README.md.html">README</a></li>
+</ul>
+<h2>Examples</h2>
+<ul class="nowrap">
+  <li><a href="../examples/app.lua.html">app.lua</a></li>
+  <li><a href="../examples/app_stream.lua.html">app_stream.lua</a></li>
+  <li><a href="../examples/copas.lua.html">copas.lua</a></li>
+  <li><a href="../examples/querystring.lua.html">querystring.lua</a></li>
+  <li><a href="../examples/write.lua.html">write.lua</a></li>
+</ul>
+
+</div>
+
+<div id="content">
+
+<h1>Class <code>pegasus.request</code></h1>
+<p>Request object available in callback handlers.</p>
+<p>
+
+
+<p> Parsed HTTP request facade used by your application callback. Instances are
+ created internally by Pegasus and passed to the callback provided to <a href="../classes/pegasus.html#Pegasus:start">pegasus:start</a>,
+ and plugin handlers.</p>
+
+<p> Fields on the object:</p>
+
+<ul>
+    <li><code>request.client</code>: the client socket (wrapped by TLS if TLS plugin is used)</li>
+    <li><code>request.server</code>: the server socket</li>
+    <li><code>request.log</code>: the logger object, to enable logging from handlers and plugins</li>
+    <li><code>request.port</code>: the port on which the request was received</li>
+    <li><code>request.ip</code>: the IP address of the client, if available (not supported by LuaSec)</li>
+    <li><code>request.response</code>: the related <a href="../classes/pegasus.response.html#">pegasus.response</a> object to write the response to</li>
+</ul>
+
+<p> Quick example:</p>
+
+
+<pre>
+server:<span class="function-name">start</span>(<span class="keyword">function</span>(req, res)
+  <span class="keyword">local</span> method = req:<span class="function-name">method</span>()
+  <span class="keyword">local</span> path = req:<span class="function-name">path</span>()
+  <span class="keyword">local</span> headers = req:<span class="function-name">headers</span>()
+  <span class="keyword">local</span> qs = req.querystring <span class="comment">-- table of query params
+</span>
+  <span class="keyword">if</span> method == <span class="string">'POST'</span> <span class="keyword">then</span>
+    <span class="keyword">local</span> form = req:<span class="function-name">post</span>() <span class="comment">-- urlencoded form body, or nil if not POST
+</span>  <span class="keyword">end</span>
+<span class="keyword">end</span>)
+</pre>
+
+</p>
+
+
+<h2><a href="#Functions">Functions</a></h2>
+<table class="function_list">
+	<tr>
+	<td class="name" nowrap><a href="#Request:headers">Request:headers ()</a></td>
+	<td class="summary">Request headers.</td>
+	</tr>
+	<tr>
+	<td class="name" nowrap><a href="#Request:method">Request:method ()</a></td>
+	<td class="summary">HTTP method.</td>
+	</tr>
+	<tr>
+	<td class="name" nowrap><a href="#Request:parseUrlEncoded">Request:parseUrlEncoded (data)</a></td>
+	<td class="summary">Parse <code>application/x-www-form-urlencoded</code> data.</td>
+	</tr>
+	<tr>
+	<td class="name" nowrap><a href="#Request:path">Request:path ()</a></td>
+	<td class="summary">Request path (normalized), without query-string.</td>
+	</tr>
+	<tr>
+	<td class="name" nowrap><a href="#Request:post">Request:post ()</a></td>
+	<td class="summary">parse POST body as <code>application/x-www-form-urlencoded</code>.</td>
+	</tr>
+	<tr>
+	<td class="name" nowrap><a href="#Request:query">Request:query ()</a></td>
+	<td class="summary">Query-string parameters.</td>
+	</tr>
+	<tr>
+	<td class="name" nowrap><a href="#Request:receiveBody">Request:receiveBody ([size])</a></td>
+	<td class="summary">Receive a chunk of the request body.</td>
+	</tr>
+</table>
+
+<br/>
+<br/>
+
+
+    <h2 class="section-header "><a name="Functions"></a>Functions</h2>
+    Methods
+    <dl class="function">
+    <dt>
+    <a name = "Request:headers"></a>
+    <strong>Request:headers ()</strong>
+    </dt>
+    <dd>
+    Request headers.
+ Returns a case-insensitive table: looking up with any casing works.
+ If a header appears multiple times, the value becomes a table of strings.
+
+
+
+    <h3>Returns:</h3>
+    <ol>
+
+           <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.6">table</a></span>
+        headers
+    </ol>
+
+
+
+
+</dd>
+    <dt>
+    <a name = "Request:method"></a>
+    <strong>Request:method ()</strong>
+    </dt>
+    <dd>
+    HTTP method.
+
+
+
+    <h3>Returns:</h3>
+    <ol>
+
+           <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
+        method
+    </ol>
+
+
+
+
+</dd>
+    <dt>
+    <a name = "Request:parseUrlEncoded"></a>
+    <strong>Request:parseUrlEncoded (data)</strong>
+    </dt>
+    <dd>
+    Parse <code>application/x-www-form-urlencoded</code> data.
+ Returns a hash table. Duplicate keys are represented as an array of values.
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">data</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
+
+
+
+        </li>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+           <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.6">table</a></span>
+        params
+    </ol>
+
+
+
+
+</dd>
+    <dt>
+    <a name = "Request:path"></a>
+    <strong>Request:path ()</strong>
+    </dt>
+    <dd>
+    Request path (normalized), without query-string.
+
+
+
+    <h3>Returns:</h3>
+    <ol>
+
+           <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
+        path
+    </ol>
+
+
+
+
+</dd>
+    <dt>
+    <a name = "Request:post"></a>
+    <strong>Request:post ()</strong>
+    </dt>
+    <dd>
+    parse POST body as <code>application/x-www-form-urlencoded</code>.
+ Returns <code>nil</code> if method is not POST.
+
+
+
+    <h3>Returns:</h3>
+    <ol>
+
+           <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.6">table</a></span>
+        parsed form values, see <a href="../classes/pegasus.request.html#Request:parseUrlEncoded">parseUrlEncoded</a> for details on the format of this table.
+    </ol>
+     <h3>Or</h3>
+    <ol>
+
+           <span class="types"><span class="type">nil</span></span>
+        when not a POST request
+    </ol>
+
+
+
+
+</dd>
+    <dt>
+    <a name = "Request:query"></a>
+    <strong>Request:query ()</strong>
+    </dt>
+    <dd>
+    Query-string parameters.
+ Returns a hash table. Duplicate keys are represented as an array of values.
+
+
+
+    <h3>Returns:</h3>
+    <ol>
+
+           <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.6">table</a></span>
+        querystring
+    </ol>
+
+
+
+
+</dd>
+    <dt>
+    <a name = "Request:receiveBody"></a>
+    <strong>Request:receiveBody ([size])</strong>
+    </dt>
+    <dd>
+    Receive a chunk of the request body.
+ Ensures headers are parsed. Returns <code>false</code> when there is no body or it is fully consumed.
+ When a socket timeout happens, any partial data is returned.
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">size</span>
+            <span class="types"><span class="type">number</span></span>
+         preferred chunk size
+         (<em>optional</em>)
+        </li>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+           <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a> or <span class="type">false</span></span>
+        chunk or false if no more content
+    </ol>
+
+
+
+
+</dd>
+</dl>
+
+
+</div> <!-- id="content" -->
+</div> <!-- id="main" -->
+<div id="about">
+<i>generated by <a href="http://github.com/lunarmodules/ldoc">LDoc 1.5.0</a></i>
+<i style="float:right;">Last updated 2026-03-30 13:29:33 </i>
+</div> <!-- id="about" -->
+</div> <!-- id="container" -->
+</body>
+</html>
diff --git a/docs/classes/pegasus.response.html b/docs/classes/pegasus.response.html
new file mode 100644
index 0000000..82e8fed
--- /dev/null
+++ b/docs/classes/pegasus.response.html
@@ -0,0 +1,583 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+<head>
+    <title>Pegasus webserver in Lua</title>
+    <link rel="stylesheet" href="../ldoc.css" type="text/css" />
+</head>
+<body>
+
+<div id="container">
+
+<div id="product">
+	<div id="product_logo"></div>
+	<div id="product_name"><big><b></b></big></div>
+	<div id="product_description"></div>
+</div> <!-- id="product" -->
+
+
+<div id="main">
+
+
+<!-- Menu -->
+
+<div id="navigation">
+<br/>
+<h1>Pegasus</h1>
+
+
+<ul>
+  <li><a href="../index.html">Index</a></li>
+</ul>
+
+<h2>Contents</h2>
+<ul>
+<li><a href="#Functions">Functions</a></li>
+</ul>
+
+
+<h2>Classes</h2>
+<ul class="nowrap">
+  <li><a href="../classes/pegasus.html">pegasus</a></li>
+  <li><a href="../classes/pegasus.handler.html">pegasus.handler</a></li>
+  <li><a href="../classes/pegasus.plugins.compress.html">pegasus.plugins.compress</a></li>
+  <li><a href="../classes/pegasus.plugins.downloads.html">pegasus.plugins.downloads</a></li>
+  <li><a href="../classes/pegasus.plugins.files.html">pegasus.plugins.files</a></li>
+  <li><a href="../classes/pegasus.plugins.router.html">pegasus.plugins.router</a></li>
+  <li><a href="../classes/pegasus.plugins.tls.html">pegasus.plugins.tls</a></li>
+  <li><a href="../classes/pegasus.request.html">pegasus.request</a></li>
+  <li><strong>pegasus.response</strong></li>
+</ul>
+<h2>Modules</h2>
+<ul class="nowrap">
+  <li><a href="../modules/logging.html">logging</a></li>
+</ul>
+<h2>Topics</h2>
+<ul class="">
+  <li><a href="../topics/LICENSE.html">LICENSE</a></li>
+  <li><a href="../topics/README.md.html">README</a></li>
+</ul>
+<h2>Examples</h2>
+<ul class="nowrap">
+  <li><a href="../examples/app.lua.html">app.lua</a></li>
+  <li><a href="../examples/app_stream.lua.html">app_stream.lua</a></li>
+  <li><a href="../examples/copas.lua.html">copas.lua</a></li>
+  <li><a href="../examples/querystring.lua.html">querystring.lua</a></li>
+  <li><a href="../examples/write.lua.html">write.lua</a></li>
+</ul>
+
+</div>
+
+<div id="content">
+
+<h1>Class <code>pegasus.response</code></h1>
+<p>Response object available in callback handlers.</p>
+<p>
+
+
+<p> HTTP response writer used by your application callback.
+ Instances are created internally by Pegasus and passed to
+ the callback provided to <a href="../classes/pegasus.html#Pegasus:start">pegasus:start</a> and plugin handlers.</p>
+
+<p> Notes:</p>
+
+<ul>
+    <li>When streaming (<code>stayOpen == true</code>), Transfer-Encoding: chunked is used.</li>
+    <li>For HEAD requests, bodies are automatically skipped.</li>
+</ul>
+
+<p> Fields on the object:</p>
+
+<ul>
+    <li><code>response.log</code>: the logger object, to enable logging from handlers and plugins</li>
+    <li><code>response.request</code>: the related <a href="../classes/pegasus.request.html#">pegasus.request</a> object</li>
+    <li><code>response.status</code>: the HTTP status code (defaults to 200), use <a href="../classes/pegasus.response.html#Response:statusCode">response:statusCode</a> to set the status</li>
+</ul>
+
+<p> Quick example:</p>
+
+
+<pre>
+server:<span class="function-name">start</span>(<span class="keyword">function</span>(req, res)
+  res:<span class="function-name">statusCode</span>(<span class="number">200</span>)
+     :<span class="function-name">contentType</span>(<span class="string">'application/json'</span>)
+     :<span class="function-name">write</span>(<span class="string">'{"ok":true}'</span>)
+<span class="keyword">end</span>)
+</pre>
+
+</p>
+
+
+<h2><a href="#Functions">Functions</a></h2>
+<table class="function_list">
+	<tr>
+	<td class="name" nowrap><a href="#Response:addHeader">Response:addHeader (key, value)</a></td>
+	<td class="summary">Add a response header.</td>
+	</tr>
+	<tr>
+	<td class="name" nowrap><a href="#Response:addHeaders">Response:addHeaders (params)</a></td>
+	<td class="summary">Add multiple headers.</td>
+	</tr>
+	<tr>
+	<td class="name" nowrap><a href="#Response:close">Response:close ()</a></td>
+	<td class="summary">Finish a chunked response and mark as closed.</td>
+	</tr>
+	<tr>
+	<td class="name" nowrap><a href="#Response:contentType">Response:contentType (value)</a></td>
+	<td class="summary">Set the <code>Content-Type</code> header.</td>
+	</tr>
+	<tr>
+	<td class="name" nowrap><a href="#Response:redirect">Response:redirect (location[, temporary])</a></td>
+	<td class="summary">Redirect to a different URL.</td>
+	</tr>
+	<tr>
+	<td class="name" nowrap><a href="#Response:sendFile">Response:sendFile (path)</a></td>
+	<td class="summary">Send a file as an attachment (download).</td>
+	</tr>
+	<tr>
+	<td class="name" nowrap><a href="#Response:sendHeaders">Response:sendHeaders ([stayOpen=false[, body]])</a></td>
+	<td class="summary">Send headers if not already sent.</td>
+	</tr>
+	<tr>
+	<td class="name" nowrap><a href="#Response:sendOnlyHeaders">Response:sendOnlyHeaders ()</a></td>
+	<td class="summary">Send only the headers, without a body.</td>
+	</tr>
+	<tr>
+	<td class="name" nowrap><a href="#Response:skipBody">Response:skipBody ([skip=true])</a></td>
+	<td class="summary">Instruct response to skip writing the response body.</td>
+	</tr>
+	<tr>
+	<td class="name" nowrap><a href="#Response:statusCode">Response:statusCode (statusCode[, statusText])</a></td>
+	<td class="summary">Set the HTTP status line.</td>
+	</tr>
+	<tr>
+	<td class="name" nowrap><a href="#Response:write">Response:write ([body=""[, stayOpen]])</a></td>
+	<td class="summary">Write response body.</td>
+	</tr>
+	<tr>
+	<td class="name" nowrap><a href="#Response:writeDefaultErrorMessage">Response:writeDefaultErrorMessage (statusCode[, errMessage])</a></td>
+	<td class="summary">Write a default HTML error body for a given status.</td>
+	</tr>
+	<tr>
+	<td class="name" nowrap><a href="#Response:writeFile">Response:writeFile (filename[, contentType])</a></td>
+	<td class="summary">Write a file to the response with a 200 status.</td>
+	</tr>
+</table>
+
+<br/>
+<br/>
+
+
+    <h2 class="section-header "><a name="Functions"></a>Functions</h2>
+    Methods
+    <dl class="function">
+    <dt>
+    <a name = "Response:addHeader"></a>
+    <strong>Response:addHeader (key, value)</strong>
+    </dt>
+    <dd>
+    Add a response header.
+ Errors if headers were already sent downstream.
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">key</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
+
+
+
+        </li>
+        <li><span class="parameter">value</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a>, <span class="type">number</span> or <span class="type">array</span></span>
+         (multiple headers by the same name can be set by passing an array of values)
+        </li>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+        The <a href="../classes/pegasus.response.html#">pegasus.response</a> object to allow chaining calls.
+    </ol>
+
+
+
+
+</dd>
+    <dt>
+    <a name = "Response:addHeaders"></a>
+    <strong>Response:addHeaders (params)</strong>
+    </dt>
+    <dd>
+    Add multiple headers.
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">params</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.6">table</a></span>
+         table of key-value pairs to add as headers (see <a href="../classes/pegasus.response.html#Response:addHeader">addHeader</a> for value types)
+        </li>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+        The <a href="../classes/pegasus.response.html#">pegasus.response</a> object to allow chaining calls.
+    </ol>
+
+
+
+
+</dd>
+    <dt>
+    <a name = "Response:close"></a>
+    <strong>Response:close ()</strong>
+    </dt>
+    <dd>
+    Finish a chunked response and mark as closed.
+ Idempotent; safe to call multiple times.
+
+
+
+    <h3>Returns:</h3>
+    <ol>
+
+        The <a href="../classes/pegasus.response.html#">pegasus.response</a> object to allow chaining calls.
+    </ol>
+
+
+
+
+</dd>
+    <dt>
+    <a name = "Response:contentType"></a>
+    <strong>Response:contentType (value)</strong>
+    </dt>
+    <dd>
+    Set the <code>Content-Type</code> header.
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">value</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
+
+
+
+        </li>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+        The <a href="../classes/pegasus.response.html#">pegasus.response</a> object to allow chaining calls.
+    </ol>
+
+
+
+
+</dd>
+    <dt>
+    <a name = "Response:redirect"></a>
+    <strong>Response:redirect (location[, temporary])</strong>
+    </dt>
+    <dd>
+    Redirect to a different URL.
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">location</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
+         destination URL
+        </li>
+        <li><span class="parameter">temporary</span>
+            <span class="types"><span class="type">boolean</span></span>
+         when true uses 302, otherwise 301
+         (<em>optional</em>)
+        </li>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+        The <a href="../classes/pegasus.response.html#">pegasus.response</a> object to allow chaining calls.
+    </ol>
+
+
+
+
+</dd>
+    <dt>
+    <a name = "Response:sendFile"></a>
+    <strong>Response:sendFile (path)</strong>
+    </dt>
+    <dd>
+    Send a file as an attachment (download).
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">path</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
+         path to file
+        </li>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+        The <a href="../classes/pegasus.response.html#">pegasus.response</a> object to allow chaining calls.
+    </ol>
+     <h3>Or</h3>
+    <ol>
+
+        nil + err on failure
+    </ol>
+
+
+
+
+</dd>
+    <dt>
+    <a name = "Response:sendHeaders"></a>
+    <strong>Response:sendHeaders ([stayOpen=false[, body]])</strong>
+    </dt>
+    <dd>
+    Send headers if not already sent.
+ Adds <code>Transfer-Encoding: chunked</code> when <code>stayOpen == true</code>; otherwise sets <code>Content-Length</code> when body is a string.
+ Also sets a default <code>Date</code> and <code>Content-Type</code> header if not present.
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">stayOpen</span>
+            <span class="types"><span class="type">boolean</span></span>
+         whether to keep the connection open for chunked streaming
+         (<em>default</em> false)
+        </li>
+        <li><span class="parameter">body</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
+         current body chunk (used to set Content-Length)
+         (<em>optional</em>)
+        </li>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+        The <a href="../classes/pegasus.response.html#">pegasus.response</a> object to allow chaining calls.
+    </ol>
+
+
+
+
+</dd>
+    <dt>
+    <a name = "Response:sendOnlyHeaders"></a>
+    <strong>Response:sendOnlyHeaders ()</strong>
+    </dt>
+    <dd>
+    Send only the headers, without a body.
+ Useful for redirects and HEAD responses.
+
+
+
+    <h3>Returns:</h3>
+    <ol>
+
+        The <a href="../classes/pegasus.response.html#">pegasus.response</a> object to allow chaining calls.
+    </ol>
+
+
+
+
+</dd>
+    <dt>
+    <a name = "Response:skipBody"></a>
+    <strong>Response:skipBody ([skip=true])</strong>
+    </dt>
+    <dd>
+    Instruct response to skip writing the response body.
+ This is automatically called by the <a href="../classes/pegasus.request.html#">pegasus.request</a> object for HEAD requests. There should be no need
+ to call this manually.
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">skip</span>
+            <span class="types"><span class="type">boolean</span></span>
+
+
+
+         (<em>default</em> true)
+        </li>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+        The <a href="../classes/pegasus.response.html#">pegasus.response</a> object to allow chaining calls.
+    </ol>
+
+
+
+
+</dd>
+    <dt>
+    <a name = "Response:statusCode"></a>
+    <strong>Response:statusCode (statusCode[, statusText])</strong>
+    </dt>
+    <dd>
+    Set the HTTP status line.
+ Must be called before headers are sent downstream.
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">statusCode</span>
+            <span class="types"><span class="type">number</span></span>
+
+
+
+        </li>
+        <li><span class="parameter">statusText</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
+         (defaults to standard text for the code)
+         (<em>optional</em>)
+        </li>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+        The <a href="../classes/pegasus.response.html#">pegasus.response</a> object to allow chaining calls.
+    </ol>
+
+
+
+
+</dd>
+    <dt>
+    <a name = "Response:write"></a>
+    <strong>Response:write ([body=""[, stayOpen]])</strong>
+    </dt>
+    <dd>
+    Write response body.
+ When <code>stayOpen == true</code>, the body is sent as a chunk and the connection remains open.
+ When <code>stayOpen ~= true</code>, headers are sent with <code>Content-Length</code> and the client-socket is closed afterwards.
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">body</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
+
+
+
+         (<em>default</em> "")
+        </li>
+        <li><span class="parameter">stayOpen</span>
+            <span class="types"><span class="type">boolean</span></span>
+
+
+
+         (<em>optional</em>)
+        </li>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+        The <a href="../classes/pegasus.response.html#">pegasus.response</a> object to allow chaining calls.
+    </ol>
+
+
+
+
+</dd>
+    <dt>
+    <a name = "Response:writeDefaultErrorMessage"></a>
+    <strong>Response:writeDefaultErrorMessage (statusCode[, errMessage])</strong>
+    </dt>
+    <dd>
+    Write a default HTML error body for a given status.
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">statusCode</span>
+            <span class="types"><span class="type">number</span></span>
+
+
+
+        </li>
+        <li><span class="parameter">errMessage</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
+
+
+
+         (<em>optional</em>)
+        </li>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+        The <a href="../classes/pegasus.response.html#">pegasus.response</a> object to allow chaining calls.
+    </ol>
+
+
+
+
+</dd>
+    <dt>
+    <a name = "Response:writeFile"></a>
+    <strong>Response:writeFile (filename[, contentType])</strong>
+    </dt>
+    <dd>
+    Write a file to the response with a 200 status.
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">filename</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
+         path to file
+        </li>
+        <li><span class="parameter">contentType</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
+         override content type, if omitted it will be guessed based on the filename extension
+         (<em>optional</em>)
+        </li>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+        The <a href="../classes/pegasus.response.html#">pegasus.response</a> object to allow chaining calls.
+    </ol>
+     <h3>Or</h3>
+    <ol>
+
+        nil + err on failure
+    </ol>
+
+
+
+
+</dd>
+</dl>
+
+
+</div> <!-- id="content" -->
+</div> <!-- id="main" -->
+<div id="about">
+<i>generated by <a href="http://github.com/lunarmodules/ldoc">LDoc 1.5.0</a></i>
+<i style="float:right;">Last updated 2026-03-30 13:29:33 </i>
+</div> <!-- id="about" -->
+</div> <!-- id="container" -->
+</body>
+</html>
diff --git a/docs/examples/app.lua.html b/docs/examples/app.lua.html
new file mode 100644
index 0000000..1490753
--- /dev/null
+++ b/docs/examples/app.lua.html
@@ -0,0 +1,215 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+<head>
+    <title>Pegasus webserver in Lua</title>
+    <link rel="stylesheet" href="../ldoc.css" type="text/css" />
+</head>
+<body>
+
+<div id="container">
+
+<div id="product">
+	<div id="product_logo"></div>
+	<div id="product_name"><big><b></b></big></div>
+	<div id="product_description"></div>
+</div> <!-- id="product" -->
+
+
+<div id="main">
+
+
+<!-- Menu -->
+
+<div id="navigation">
+<br/>
+<h1>Pegasus</h1>
+
+
+<ul>
+  <li><a href="../index.html">Index</a></li>
+</ul>
+
+
+
+<h2>Examples</h2>
+<ul class="nowrap">
+  <li><strong>app.lua</strong></li>
+  <li><a href="../examples/app_stream.lua.html">app_stream.lua</a></li>
+  <li><a href="../examples/copas.lua.html">copas.lua</a></li>
+  <li><a href="../examples/querystring.lua.html">querystring.lua</a></li>
+  <li><a href="../examples/write.lua.html">write.lua</a></li>
+</ul>
+<h2>Modules</h2>
+<ul class="nowrap">
+  <li><a href="../modules/logging.html">logging</a></li>
+</ul>
+<h2>Classes</h2>
+<ul class="nowrap">
+  <li><a href="../classes/pegasus.html">pegasus</a></li>
+  <li><a href="../classes/pegasus.handler.html">pegasus.handler</a></li>
+  <li><a href="../classes/pegasus.plugins.compress.html">pegasus.plugins.compress</a></li>
+  <li><a href="../classes/pegasus.plugins.downloads.html">pegasus.plugins.downloads</a></li>
+  <li><a href="../classes/pegasus.plugins.files.html">pegasus.plugins.files</a></li>
+  <li><a href="../classes/pegasus.plugins.router.html">pegasus.plugins.router</a></li>
+  <li><a href="../classes/pegasus.plugins.tls.html">pegasus.plugins.tls</a></li>
+  <li><a href="../classes/pegasus.request.html">pegasus.request</a></li>
+  <li><a href="../classes/pegasus.response.html">pegasus.response</a></li>
+</ul>
+<h2>Topics</h2>
+<ul class="">
+  <li><a href="../topics/LICENSE.html">LICENSE</a></li>
+  <li><a href="../topics/README.md.html">README</a></li>
+</ul>
+
+</div>
+
+<div id="content">
+
+    <h2>app.lua</h2>
+<pre>
+<span class="comment">-- setup path to find the project source files of Pegasus
+</span><span class="global">package</span>.path = <span class="string">'./src/?.lua;./src/?/init.lua;'</span> .. <span class="global">package</span>.path
+
+<span class="comment">-- For this example to work with the https version, you need LuaSec
+</span><span class="comment">-- to be installed, and you need to generate the test certificates from
+</span><span class="comment">-- its examples. Copy the 'A' certificates into this example directory
+</span><span class="comment">-- to make it work.
+</span><span class="comment">-- Then uncomment the TLS plugin section below.
+</span><span class="comment">-- Additionally you need lua-cjson to be installed.
+</span>
+<span class="keyword">local</span> Pegasus = <span class="global">require</span> <span class="string">'pegasus'</span>
+<span class="keyword">local</span> Compress = <span class="global">require</span> <span class="string">'pegasus.plugins.compress'</span>
+<span class="keyword">local</span> Downloads = <span class="global">require</span> <span class="string">'pegasus.plugins.downloads'</span>
+<span class="keyword">local</span> Files = <span class="global">require</span> <span class="string">'pegasus.plugins.files'</span>
+<span class="keyword">local</span> Router = <span class="global">require</span> <span class="string">'pegasus.plugins.router'</span>
+<span class="keyword">local</span> json = <span class="global">require</span> <span class="string">'cjson.safe'</span>
+<span class="comment">-- local TLS = require 'pegasus.plugins.tls'
+</span>
+
+<span class="comment">-- example data for the "router" plugin
+</span><span class="keyword">local</span> routes <span class="keyword">do</span>
+  <span class="keyword">local</span> testData = {
+    Jane = { firstName = <span class="string">"Jane"</span>, lastName = <span class="string">"Doe"</span>, age = <span class="number">25</span> },
+    John = { firstName = <span class="string">"John"</span>, lastName = <span class="string">"Doe"</span>, age = <span class="number">30</span> },
+  }
+
+  routes = {
+    <span class="comment">-- router-level preFunction runs before the method prefunction and callback
+</span>    preFunction = <span class="keyword">function</span>(req, resp)
+      <span class="keyword">local</span> stop = <span class="keyword">false</span>
+      <span class="keyword">local</span> headers = req:<span class="function-name">headers</span>()
+      <span class="keyword">local</span> accept = (headers.accept <span class="keyword">or</span> <span class="string">"*/*"</span>):<span class="function-name">lower</span>()
+      <span class="keyword">if</span> <span class="keyword">not</span> accept:<span class="function-name">find</span>(<span class="string">"application/json"</span>, <span class="number">1</span>, <span class="keyword">true</span>) <span class="keyword">and</span>
+         <span class="keyword">not</span> accept:<span class="function-name">find</span>(<span class="string">"application/*"</span>, <span class="number">1</span>, <span class="keyword">true</span>) <span class="keyword">and</span>
+         <span class="keyword">not</span> accept:<span class="function-name">find</span>(<span class="string">"*/*"</span>, <span class="number">1</span>, <span class="keyword">true</span>) <span class="keyword">then</span>
+
+        resp:<span class="function-name">writeDefaultErrorMessage</span>(<span class="number">406</span>, <span class="string">"This API only produces 'application/json'"</span>)
+        stop = <span class="keyword">true</span>
+      <span class="keyword">end</span>
+      <span class="keyword">return</span> stop
+    <span class="keyword">end</span>,
+
+    [<span class="string">"/people"</span>] = {
+      GET = <span class="keyword">function</span>(req, resp)
+        resp:<span class="function-name">statusCode</span>(<span class="number">200</span>)
+        resp:<span class="function-name">addHeader</span>(<span class="string">"Content-Type"</span>, <span class="string">"application/json"</span>)
+        resp:<span class="function-name">write</span>(json.<span class="function-name">encode</span>(testData))
+      <span class="keyword">end</span>,
+    },
+
+    [<span class="string">"/people/{name}"</span>] = {
+      <span class="comment">-- path-level preFunction runs before the actual method callback
+</span>      preFunction = <span class="keyword">function</span>(req, resp)
+        <span class="keyword">local</span> stop = <span class="keyword">false</span>
+        <span class="keyword">local</span> name = req.pathParameters.name
+        <span class="keyword">if</span> <span class="keyword">not</span> testData[name] <span class="keyword">then</span>
+          <span class="keyword">local</span> err = (<span class="string">"'%s' is an unknown person"</span>):<span class="function-name">format</span>(name)
+          req.log:<span class="global">error</span>(err)
+          resp:<span class="function-name">writeDefaultErrorMessage</span>(<span class="number">404</span>, err)
+          stop = <span class="keyword">true</span>
+        <span class="keyword">end</span>
+        <span class="keyword">return</span> stop
+      <span class="keyword">end</span>,
+
+      <span class="comment">-- callback per method
+</span>      GET = <span class="keyword">function</span>(req, resp)
+        resp:<span class="function-name">statusCode</span>(<span class="number">200</span>)
+        resp:<span class="function-name">addHeader</span>(<span class="string">"Content-Type"</span>, <span class="string">"application/json"</span>)
+        resp:<span class="function-name">write</span>(json.<span class="function-name">encode</span>(testData[req.pathParameters.name]))
+      <span class="keyword">end</span>,
+
+      <span class="comment">-- postFunction runs after the actual method callback
+</span>      postFunction = <span class="keyword">function</span>(req, resp)
+        <span class="keyword">local</span> stop = <span class="keyword">false</span>
+        req.log:<span class="global">debug</span>(<span class="string">"served %s's data"</span>, req.pathParameters.name)
+        <span class="keyword">return</span> stop
+      <span class="keyword">end</span>,
+    }
+  }
+<span class="keyword">end</span>
+
+
+<span class="keyword">local</span> server = Pegasus:<span class="function-name">new</span>({
+  port = <span class="string">'9090'</span>,
+  plugins = {
+    <span class="comment">-- TLS:new {  -- the tls specific configuration
+</span>    <span class="comment">--   wrap = {
+</span>    <span class="comment">--     mode = "server",
+</span>    <span class="comment">--     protocol = "any",
+</span>    <span class="comment">--     key = "./example/serverAkey.pem",
+</span>    <span class="comment">--     certificate = "./example/serverA.pem",
+</span>    <span class="comment">--     cafile = "./example/rootA.pem",
+</span>    <span class="comment">--     verify = {"none"},
+</span>    <span class="comment">--     options = {"all", "no_sslv2", "no_sslv3", "no_tlsv1"},
+</span>    <span class="comment">--   },
+</span>    <span class="comment">--   sni = nil,
+</span>    <span class="comment">-- },
+</span>
+    Downloads:<span class="function-name">new</span> {
+      location = <span class="string">'/example/root/'</span>,
+      prefix = <span class="string">'downloads'</span>,
+      stripPrefix = <span class="keyword">true</span>,
+    },
+
+    Files:<span class="function-name">new</span> {
+      location = <span class="string">'/example/root/'</span>,
+    },
+
+    Router:<span class="function-name">new</span> {
+      prefix = <span class="string">"/api/1v0/"</span>,
+      routes = routes,
+    },
+
+    Compress:<span class="function-name">new</span>(),
+  }
+})
+
+server:<span class="function-name">start</span>(<span class="keyword">function</span>(req, resp)
+  <span class="keyword">local</span> stop = <span class="keyword">false</span>
+
+  <span class="keyword">local</span> path = req:<span class="function-name">path</span>()
+  <span class="keyword">if</span> req:<span class="function-name">method</span>() ~= <span class="string">"POST"</span> <span class="keyword">or</span> path ~= <span class="string">"/index.html"</span> <span class="keyword">then</span>
+    <span class="keyword">return</span> stop
+  <span class="keyword">end</span>
+
+  <span class="keyword">local</span> data = req:<span class="function-name">post</span>()
+  <span class="keyword">if</span> data <span class="keyword">then</span>
+    <span class="global">print</span>(<span class="string">"Name: "</span>, data.name)
+    <span class="global">print</span>(<span class="string">"Age: "</span>, data.age)
+  <span class="keyword">end</span>
+  stop = <span class="keyword">not</span> <span class="keyword">not</span> resp:<span class="function-name">writeFile</span>(<span class="string">"./example/root"</span> .. path)
+  <span class="keyword">return</span> stop
+<span class="keyword">end</span>)</pre>
+
+
+</div> <!-- id="content" -->
+</div> <!-- id="main" -->
+<div id="about">
+<i>generated by <a href="http://github.com/lunarmodules/ldoc">LDoc 1.5.0</a></i>
+<i style="float:right;">Last updated 2026-03-30 13:29:33 </i>
+</div> <!-- id="about" -->
+</div> <!-- id="container" -->
+</body>
+</html>
diff --git a/docs/examples/app_stream.lua.html b/docs/examples/app_stream.lua.html
new file mode 100644
index 0000000..e27ca74
--- /dev/null
+++ b/docs/examples/app_stream.lua.html
@@ -0,0 +1,105 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+<head>
+    <title>Pegasus webserver in Lua</title>
+    <link rel="stylesheet" href="../ldoc.css" type="text/css" />
+</head>
+<body>
+
+<div id="container">
+
+<div id="product">
+	<div id="product_logo"></div>
+	<div id="product_name"><big><b></b></big></div>
+	<div id="product_description"></div>
+</div> <!-- id="product" -->
+
+
+<div id="main">
+
+
+<!-- Menu -->
+
+<div id="navigation">
+<br/>
+<h1>Pegasus</h1>
+
+
+<ul>
+  <li><a href="../index.html">Index</a></li>
+</ul>
+
+
+
+<h2>Examples</h2>
+<ul class="nowrap">
+  <li><a href="../examples/app.lua.html">app.lua</a></li>
+  <li><strong>app_stream.lua</strong></li>
+  <li><a href="../examples/copas.lua.html">copas.lua</a></li>
+  <li><a href="../examples/querystring.lua.html">querystring.lua</a></li>
+  <li><a href="../examples/write.lua.html">write.lua</a></li>
+</ul>
+<h2>Modules</h2>
+<ul class="nowrap">
+  <li><a href="../modules/logging.html">logging</a></li>
+</ul>
+<h2>Classes</h2>
+<ul class="nowrap">
+  <li><a href="../classes/pegasus.html">pegasus</a></li>
+  <li><a href="../classes/pegasus.handler.html">pegasus.handler</a></li>
+  <li><a href="../classes/pegasus.plugins.compress.html">pegasus.plugins.compress</a></li>
+  <li><a href="../classes/pegasus.plugins.downloads.html">pegasus.plugins.downloads</a></li>
+  <li><a href="../classes/pegasus.plugins.files.html">pegasus.plugins.files</a></li>
+  <li><a href="../classes/pegasus.plugins.router.html">pegasus.plugins.router</a></li>
+  <li><a href="../classes/pegasus.plugins.tls.html">pegasus.plugins.tls</a></li>
+  <li><a href="../classes/pegasus.request.html">pegasus.request</a></li>
+  <li><a href="../classes/pegasus.response.html">pegasus.response</a></li>
+</ul>
+<h2>Topics</h2>
+<ul class="">
+  <li><a href="../topics/LICENSE.html">LICENSE</a></li>
+  <li><a href="../topics/README.md.html">README</a></li>
+</ul>
+
+</div>
+
+<div id="content">
+
+    <h2>app_stream.lua</h2>
+<pre>
+<span class="comment">-- setup path to find the project source files of Pegasus
+</span><span class="global">package</span>.path = <span class="string">"./src/?.lua;./src/?/init.lua;"</span>..<span class="global">package</span>.path
+
+<span class="keyword">local</span> Pegasus = <span class="global">require</span> <span class="string">'pegasus'</span>
+<span class="keyword">local</span> socket = <span class="global">require</span> <span class="string">'socket'</span>
+
+<span class="keyword">local</span> server = Pegasus:<span class="function-name">new</span>({
+  port=<span class="string">'9090'</span>
+})
+<span class="keyword">local</span> <span class="keyword">function</span> <span class="function-name">sleep</span>(sec)
+  socket.<span class="global">select</span>(<span class="keyword">nil</span>, <span class="keyword">nil</span>, sec)
+<span class="keyword">end</span>
+
+server:<span class="function-name">start</span>(<span class="keyword">function</span>(req, res)
+  res:<span class="function-name">write</span>(<span class="string">'a'</span>, <span class="keyword">true</span>)
+  <span class="function-name">sleep</span>(<span class="number">3</span>)
+  res:<span class="function-name">write</span>(<span class="string">'b'</span>, <span class="keyword">true</span>)
+  <span class="function-name">sleep</span>(<span class="number">3</span>)
+  res:<span class="function-name">write</span>(<span class="string">'c'</span>, <span class="keyword">true</span>)
+
+  <span class="comment">-- return a truthy value to indicate the request was handled, no further handling needed
+</span>  <span class="keyword">return</span> res:<span class="function-name">close</span>()
+<span class="keyword">end</span>)</pre>
+
+
+</div> <!-- id="content" -->
+</div> <!-- id="main" -->
+<div id="about">
+<i>generated by <a href="http://github.com/lunarmodules/ldoc">LDoc 1.5.0</a></i>
+<i style="float:right;">Last updated 2026-03-30 13:29:33 </i>
+</div> <!-- id="about" -->
+</div> <!-- id="container" -->
+</body>
+</html>
diff --git a/docs/examples/copas.lua.html b/docs/examples/copas.lua.html
new file mode 100644
index 0000000..4b42b37
--- /dev/null
+++ b/docs/examples/copas.lua.html
@@ -0,0 +1,264 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+<head>
+    <title>Pegasus webserver in Lua</title>
+    <link rel="stylesheet" href="../ldoc.css" type="text/css" />
+</head>
+<body>
+
+<div id="container">
+
+<div id="product">
+	<div id="product_logo"></div>
+	<div id="product_name"><big><b></b></big></div>
+	<div id="product_description"></div>
+</div> <!-- id="product" -->
+
+
+<div id="main">
+
+
+<!-- Menu -->
+
+<div id="navigation">
+<br/>
+<h1>Pegasus</h1>
+
+
+<ul>
+  <li><a href="../index.html">Index</a></li>
+</ul>
+
+
+
+<h2>Examples</h2>
+<ul class="nowrap">
+  <li><a href="../examples/app.lua.html">app.lua</a></li>
+  <li><a href="../examples/app_stream.lua.html">app_stream.lua</a></li>
+  <li><strong>copas.lua</strong></li>
+  <li><a href="../examples/querystring.lua.html">querystring.lua</a></li>
+  <li><a href="../examples/write.lua.html">write.lua</a></li>
+</ul>
+<h2>Modules</h2>
+<ul class="nowrap">
+  <li><a href="../modules/logging.html">logging</a></li>
+</ul>
+<h2>Classes</h2>
+<ul class="nowrap">
+  <li><a href="../classes/pegasus.html">pegasus</a></li>
+  <li><a href="../classes/pegasus.handler.html">pegasus.handler</a></li>
+  <li><a href="../classes/pegasus.plugins.compress.html">pegasus.plugins.compress</a></li>
+  <li><a href="../classes/pegasus.plugins.downloads.html">pegasus.plugins.downloads</a></li>
+  <li><a href="../classes/pegasus.plugins.files.html">pegasus.plugins.files</a></li>
+  <li><a href="../classes/pegasus.plugins.router.html">pegasus.plugins.router</a></li>
+  <li><a href="../classes/pegasus.plugins.tls.html">pegasus.plugins.tls</a></li>
+  <li><a href="../classes/pegasus.request.html">pegasus.request</a></li>
+  <li><a href="../classes/pegasus.response.html">pegasus.response</a></li>
+</ul>
+<h2>Topics</h2>
+<ul class="">
+  <li><a href="../topics/LICENSE.html">LICENSE</a></li>
+  <li><a href="../topics/README.md.html">README</a></li>
+</ul>
+
+</div>
+
+<div id="content">
+
+    <h2>copas.lua</h2>
+<pre>
+<span class="comment">-- setup path to find the project source files of Pegasus
+</span><span class="global">package</span>.path = <span class="string">"./src/?.lua;./src/?/init.lua;"</span>..<span class="global">package</span>.path
+
+
+<span class="comment">-- Example that uses Copas as a socket scheduler, allowing multiple
+</span><span class="comment">-- servers to work in parallel.
+</span><span class="comment">-- For this example to work with the https version, you need LuaSec
+</span><span class="comment">-- to be installed, and you need to generate the test certificates from
+</span><span class="comment">-- its examples. Copy the 'A' certificates into this example directory
+</span><span class="comment">-- to make it work.
+</span><span class="comment">-- Additionally you need lua-cjson to be installed.
+</span>
+<span class="comment">-- require lualogging if available, "pegasus.log" will automatically pick it up
+</span><span class="global">pcall</span>(<span class="global">require</span>, <span class="string">'logging'</span>)
+
+<span class="keyword">local</span> Handler = <span class="global">require</span> <span class="string">'pegasus.handler'</span>
+<span class="keyword">local</span> copas = <span class="global">require</span>(<span class="string">'copas'</span>)
+<span class="keyword">local</span> socket = <span class="global">require</span>(<span class="string">'socket'</span>)
+<span class="keyword">local</span> Downloads = <span class="global">require</span> <span class="string">'pegasus.plugins.downloads'</span>
+<span class="keyword">local</span> Files = <span class="global">require</span> <span class="string">'pegasus.plugins.files'</span>
+<span class="keyword">local</span> Router = <span class="global">require</span> <span class="string">'pegasus.plugins.router'</span>
+<span class="keyword">local</span> Compress = <span class="global">require</span> <span class="string">'pegasus.plugins.compress'</span>
+<span class="keyword">local</span> json = <span class="global">require</span> <span class="string">'cjson.safe'</span>
+
+
+<span class="comment">--- Creates a new server within the Copas scheduler.
+</span><span class="comment">-- @tparam table opts options table.
+</span><span class="comment">-- @tparam[opt='*'] string opts.interface the interface to listen on, or '*' for all.
+</span><span class="comment">-- @tparam string          opts.port the port number to listen on.
+</span><span class="comment">-- @tparam[opt] table      opts.sslparams the tls based parameters, see the Copas documentation.
+</span><span class="comment">--                         If not provided, then the connection will be accepted as a plain one.
+</span><span class="comment">-- @tparam[opt] table      opts.plugins the plugins to use
+</span><span class="comment">-- @tparam[opt] function   opts.callback the callback function to handle requests
+</span><span class="comment">-- @tparam[opt] string     opts.location the file-path from where to serve files
+</span><span class="comment">-- @tparam[opt] logger     opts.log the LuaLogging logger to use (defaults to LuaLogging default logger)
+</span><span class="comment">-- @return the server-socket on success, or nil+err on failure
+</span><span class="keyword">local</span> <span class="keyword">function</span> <span class="function-name">newPegasusServer</span>(opts)
+  opts = opts <span class="keyword">or</span> {}
+  <span class="global">assert</span>(opts.port, <span class="string">"option 'port' must be provided"</span>)
+
+  <span class="keyword">local</span> server_sock, err = socket.<span class="function-name">bind</span>(opts.interface <span class="keyword">or</span> <span class="string">'*'</span>, opts.port)
+  <span class="keyword">if</span> <span class="keyword">not</span> server_sock <span class="keyword">then</span>
+    <span class="keyword">return</span> <span class="keyword">nil</span>, <span class="string">"failed to create server socket; "</span>.. <span class="global">tostring</span>(err)
+  <span class="keyword">end</span>
+
+  <span class="keyword">local</span> server_ip, server_port = server_sock:<span class="function-name">getsockname</span>()
+  <span class="keyword">if</span> <span class="keyword">not</span> server_ip <span class="keyword">then</span>
+    <span class="keyword">return</span> <span class="keyword">nil</span>, <span class="string">"failed to get server socket name; "</span>..<span class="global">tostring</span>(server_port)
+  <span class="keyword">else</span>
+    <span class="keyword">if</span> server_ip == <span class="string">"0.0.0.0"</span> <span class="keyword">then</span>
+      server_ip = <span class="string">"localhost"</span>
+    <span class="keyword">end</span>
+  <span class="keyword">end</span>
+
+  <span class="keyword">local</span> hdlr = Handler:<span class="function-name">new</span>(opts.callback, opts.location, opts.plugins, opts.log)
+
+  copas.<span class="function-name">addserver</span>(server_sock, copas.<span class="function-name">handler</span>(<span class="keyword">function</span>(client_sock)
+    hdlr:<span class="function-name">processRequest</span>(server_port, client_sock)
+  <span class="keyword">end</span>, opts.sslparams))
+
+  hdlr.log:<span class="function-name">info</span>(<span class="string">'Pegasus is up on %s://%s:%s'</span>, opts.sslparams <span class="keyword">and</span> <span class="string">"https"</span> <span class="keyword">or</span> <span class="string">"http"</span>, server_ip, server_port)
+  <span class="keyword">return</span> server_sock
+<span class="keyword">end</span>
+
+
+<span class="comment">-- example data for the "router" plugin
+</span><span class="keyword">local</span> routes <span class="keyword">do</span>
+  <span class="keyword">local</span> testData = {
+    Jane = { firstName = <span class="string">"Jane"</span>, lastName = <span class="string">"Doe"</span>, age = <span class="number">25</span> },
+    John = { firstName = <span class="string">"John"</span>, lastName = <span class="string">"Doe"</span>, age = <span class="number">30</span> },
+  }
+
+  routes = {
+    <span class="comment">-- router-level preFunction runs before the method prefunction and callback
+</span>    preFunction = <span class="keyword">function</span>(req, resp)
+      <span class="keyword">local</span> stop = <span class="keyword">false</span>
+      <span class="keyword">local</span> headers = req:<span class="function-name">headers</span>()
+      <span class="keyword">local</span> accept = (headers.accept <span class="keyword">or</span> <span class="string">"*/*"</span>):<span class="function-name">lower</span>()
+      <span class="keyword">if</span> <span class="keyword">not</span> accept:<span class="function-name">find</span>(<span class="string">"application/json"</span>, <span class="number">1</span>, <span class="keyword">true</span>) <span class="keyword">and</span>
+         <span class="keyword">not</span> accept:<span class="function-name">find</span>(<span class="string">"application/*"</span>, <span class="number">1</span>, <span class="keyword">true</span>) <span class="keyword">and</span>
+         <span class="keyword">not</span> accept:<span class="function-name">find</span>(<span class="string">"*/*"</span>, <span class="number">1</span>, <span class="keyword">true</span>) <span class="keyword">then</span>
+
+        resp:<span class="function-name">writeDefaultErrorMessage</span>(<span class="number">406</span>, <span class="string">"This API only produces 'application/json'"</span>)
+        stop = <span class="keyword">true</span>
+      <span class="keyword">end</span>
+      <span class="keyword">return</span> stop
+    <span class="keyword">end</span>,
+
+    [<span class="string">"/people"</span>] = {
+      GET = <span class="keyword">function</span>(req, resp)
+        resp:<span class="function-name">statusCode</span>(<span class="number">200</span>)
+        resp:<span class="function-name">addHeader</span>(<span class="string">"Content-Type"</span>, <span class="string">"application/json"</span>)
+        resp:<span class="function-name">write</span>(json.<span class="function-name">encode</span>(testData))
+      <span class="keyword">end</span>,
+    },
+
+    [<span class="string">"/people/{name}"</span>] = {
+      <span class="comment">-- path-level preFunction runs before the actual method callback
+</span>      preFunction = <span class="keyword">function</span>(req, resp)
+        <span class="keyword">local</span> stop = <span class="keyword">false</span>
+        <span class="keyword">local</span> name = req.pathParameters.name
+        <span class="keyword">if</span> <span class="keyword">not</span> testData[name] <span class="keyword">then</span>
+          <span class="keyword">local</span> err = (<span class="string">"'%s' is an unknown person"</span>):<span class="function-name">format</span>(name)
+          req.log:<span class="global">error</span>(err)
+          resp:<span class="function-name">writeDefaultErrorMessage</span>(<span class="number">404</span>, err)
+          stop = <span class="keyword">true</span>
+        <span class="keyword">end</span>
+        <span class="keyword">return</span> stop
+      <span class="keyword">end</span>,
+
+      <span class="comment">-- callback per method
+</span>      GET = <span class="keyword">function</span>(req, resp)
+        resp:<span class="function-name">statusCode</span>(<span class="number">200</span>)
+        resp:<span class="function-name">addHeader</span>(<span class="string">"Content-Type"</span>, <span class="string">"application/json"</span>)
+        resp:<span class="function-name">write</span>(json.<span class="function-name">encode</span>(testData[req.pathParameters.name]))
+      <span class="keyword">end</span>,
+
+      <span class="comment">-- postFunction runs after the actual method callback
+</span>      postFunction = <span class="keyword">function</span>(req, resp)
+        <span class="keyword">local</span> stop = <span class="keyword">false</span>
+        req.log:<span class="global">debug</span>(<span class="string">"served %s's data"</span>, req.pathParameters.name)
+        <span class="keyword">return</span> stop
+      <span class="keyword">end</span>,
+    }
+  }
+<span class="keyword">end</span>
+
+
+
+<span class="comment">-- Create http server
+</span><span class="global">assert</span>(<span class="function-name">newPegasusServer</span>{
+  interface = <span class="string">"*"</span>,
+  port = <span class="string">"9090"</span>,
+  sslparams = <span class="keyword">nil</span>,
+  location = <span class="keyword">nil</span>,
+  callback = <span class="keyword">function</span>(req, resp) <span class="comment">-- just redirecting to the https one
+</span>    <span class="keyword">local</span> host = (req:<span class="function-name">headers</span>()[<span class="string">"Host"</span>] <span class="keyword">or</span> <span class="string">""</span>):<span class="function-name">match</span>(<span class="string">"^([^:]+)"</span>)
+    resp:<span class="function-name">redirect</span>(<span class="string">"https://"</span> .. host .. <span class="string">":9091"</span> .. req:<span class="function-name">path</span>())
+  <span class="keyword">end</span>,
+  plugins = {},
+})
+
+
+<span class="comment">-- Create https server
+</span><span class="global">assert</span>(<span class="function-name">newPegasusServer</span>{
+  interface = <span class="string">"*"</span>,
+  port = <span class="string">"9091"</span>,
+  sslparams = {  <span class="comment">-- the tls specific configuration
+</span>    wrap = {
+      mode = <span class="string">"server"</span>,
+      protocol = <span class="string">"any"</span>,
+      key = <span class="string">"./example/serverAkey.pem"</span>,
+      certificate = <span class="string">"./example/serverA.pem"</span>,
+      cafile = <span class="string">"./example/rootA.pem"</span>,
+      verify = {<span class="string">"none"</span>},
+      options = {<span class="string">"all"</span>, <span class="string">"no_sslv2"</span>, <span class="string">"no_sslv3"</span>, <span class="string">"no_tlsv1"</span>},
+    },
+    sni = <span class="keyword">nil</span>,
+  },
+
+  plugins = {
+    Downloads:<span class="function-name">new</span> {
+      location = <span class="string">'/example/root/'</span>,
+      prefix = <span class="string">'downloads'</span>,
+      stripPrefix = <span class="keyword">true</span>,
+    },
+
+    Files:<span class="function-name">new</span> {
+      location = <span class="string">'/example/root/'</span>,
+    },
+
+    Router:<span class="function-name">new</span> {
+      prefix = <span class="string">"/api/1v0/"</span>,
+      routes = routes,
+    },
+
+    Compress:<span class="function-name">new</span>(),
+  }
+})
+
+<span class="comment">-- Start
+</span>copas.<span class="function-name">loop</span>()</pre>
+
+
+</div> <!-- id="content" -->
+</div> <!-- id="main" -->
+<div id="about">
+<i>generated by <a href="http://github.com/lunarmodules/ldoc">LDoc 1.5.0</a></i>
+<i style="float:right;">Last updated 2026-03-30 13:29:33 </i>
+</div> <!-- id="about" -->
+</div> <!-- id="container" -->
+</body>
+</html>
diff --git a/docs/examples/querystring.lua.html b/docs/examples/querystring.lua.html
new file mode 100644
index 0000000..f467142
--- /dev/null
+++ b/docs/examples/querystring.lua.html
@@ -0,0 +1,104 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+<head>
+    <title>Pegasus webserver in Lua</title>
+    <link rel="stylesheet" href="../ldoc.css" type="text/css" />
+</head>
+<body>
+
+<div id="container">
+
+<div id="product">
+	<div id="product_logo"></div>
+	<div id="product_name"><big><b></b></big></div>
+	<div id="product_description"></div>
+</div> <!-- id="product" -->
+
+
+<div id="main">
+
+
+<!-- Menu -->
+
+<div id="navigation">
+<br/>
+<h1>Pegasus</h1>
+
+
+<ul>
+  <li><a href="../index.html">Index</a></li>
+</ul>
+
+
+
+<h2>Examples</h2>
+<ul class="nowrap">
+  <li><a href="../examples/app.lua.html">app.lua</a></li>
+  <li><a href="../examples/app_stream.lua.html">app_stream.lua</a></li>
+  <li><a href="../examples/copas.lua.html">copas.lua</a></li>
+  <li><strong>querystring.lua</strong></li>
+  <li><a href="../examples/write.lua.html">write.lua</a></li>
+</ul>
+<h2>Modules</h2>
+<ul class="nowrap">
+  <li><a href="../modules/logging.html">logging</a></li>
+</ul>
+<h2>Classes</h2>
+<ul class="nowrap">
+  <li><a href="../classes/pegasus.html">pegasus</a></li>
+  <li><a href="../classes/pegasus.handler.html">pegasus.handler</a></li>
+  <li><a href="../classes/pegasus.plugins.compress.html">pegasus.plugins.compress</a></li>
+  <li><a href="../classes/pegasus.plugins.downloads.html">pegasus.plugins.downloads</a></li>
+  <li><a href="../classes/pegasus.plugins.files.html">pegasus.plugins.files</a></li>
+  <li><a href="../classes/pegasus.plugins.router.html">pegasus.plugins.router</a></li>
+  <li><a href="../classes/pegasus.plugins.tls.html">pegasus.plugins.tls</a></li>
+  <li><a href="../classes/pegasus.request.html">pegasus.request</a></li>
+  <li><a href="../classes/pegasus.response.html">pegasus.response</a></li>
+</ul>
+<h2>Topics</h2>
+<ul class="">
+  <li><a href="../topics/LICENSE.html">LICENSE</a></li>
+  <li><a href="../topics/README.md.html">README</a></li>
+</ul>
+
+</div>
+
+<div id="content">
+
+    <h2>querystring.lua</h2>
+<pre>
+<span class="comment">-- setup path to find the project source files of Pegasus
+</span><span class="global">package</span>.path = <span class="string">"./src/?.lua;./src/?/init.lua;"</span>..<span class="global">package</span>.path
+
+<span class="keyword">local</span> pegasus = <span class="global">require</span> <span class="string">'pegasus'</span>
+
+<span class="keyword">local</span> server = pegasus:<span class="function-name">new</span>({
+  port = <span class="string">'9090'</span>,
+})
+
+<span class="keyword">local</span> printTable = <span class="keyword">function</span>(<span class="global">table</span>)
+  <span class="keyword">for</span> k, v <span class="keyword">in</span> <span class="global">pairs</span>(<span class="global">table</span>) <span class="keyword">do</span>
+    <span class="global">print</span>(k, <span class="string">'='</span>, v)
+  <span class="keyword">end</span>
+<span class="keyword">end</span>
+
+server:<span class="function-name">start</span>(<span class="keyword">function</span> (req, res)
+  <span class="function-name">printTable</span>(req:<span class="function-name">query</span>())
+  res:<span class="function-name">addHeader</span>(<span class="string">'Content-Type'</span>, <span class="string">'text/html'</span>):<span class="function-name">write</span>(<span class="string">'hello pegasus world!'</span>)
+
+  <span class="comment">-- return a truthy value to indicate the request was handled, no further handling needed
+</span>  <span class="keyword">return</span> res:<span class="function-name">close</span>()
+<span class="keyword">end</span>)</pre>
+
+
+</div> <!-- id="content" -->
+</div> <!-- id="main" -->
+<div id="about">
+<i>generated by <a href="http://github.com/lunarmodules/ldoc">LDoc 1.5.0</a></i>
+<i style="float:right;">Last updated 2026-03-30 13:29:33 </i>
+</div> <!-- id="about" -->
+</div> <!-- id="container" -->
+</body>
+</html>
diff --git a/docs/examples/write.lua.html b/docs/examples/write.lua.html
new file mode 100644
index 0000000..f6bac84
--- /dev/null
+++ b/docs/examples/write.lua.html
@@ -0,0 +1,95 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+<head>
+    <title>Pegasus webserver in Lua</title>
+    <link rel="stylesheet" href="../ldoc.css" type="text/css" />
+</head>
+<body>
+
+<div id="container">
+
+<div id="product">
+	<div id="product_logo"></div>
+	<div id="product_name"><big><b></b></big></div>
+	<div id="product_description"></div>
+</div> <!-- id="product" -->
+
+
+<div id="main">
+
+
+<!-- Menu -->
+
+<div id="navigation">
+<br/>
+<h1>Pegasus</h1>
+
+
+<ul>
+  <li><a href="../index.html">Index</a></li>
+</ul>
+
+
+
+<h2>Examples</h2>
+<ul class="nowrap">
+  <li><a href="../examples/app.lua.html">app.lua</a></li>
+  <li><a href="../examples/app_stream.lua.html">app_stream.lua</a></li>
+  <li><a href="../examples/copas.lua.html">copas.lua</a></li>
+  <li><a href="../examples/querystring.lua.html">querystring.lua</a></li>
+  <li><strong>write.lua</strong></li>
+</ul>
+<h2>Modules</h2>
+<ul class="nowrap">
+  <li><a href="../modules/logging.html">logging</a></li>
+</ul>
+<h2>Classes</h2>
+<ul class="nowrap">
+  <li><a href="../classes/pegasus.html">pegasus</a></li>
+  <li><a href="../classes/pegasus.handler.html">pegasus.handler</a></li>
+  <li><a href="../classes/pegasus.plugins.compress.html">pegasus.plugins.compress</a></li>
+  <li><a href="../classes/pegasus.plugins.downloads.html">pegasus.plugins.downloads</a></li>
+  <li><a href="../classes/pegasus.plugins.files.html">pegasus.plugins.files</a></li>
+  <li><a href="../classes/pegasus.plugins.router.html">pegasus.plugins.router</a></li>
+  <li><a href="../classes/pegasus.plugins.tls.html">pegasus.plugins.tls</a></li>
+  <li><a href="../classes/pegasus.request.html">pegasus.request</a></li>
+  <li><a href="../classes/pegasus.response.html">pegasus.response</a></li>
+</ul>
+<h2>Topics</h2>
+<ul class="">
+  <li><a href="../topics/LICENSE.html">LICENSE</a></li>
+  <li><a href="../topics/README.md.html">README</a></li>
+</ul>
+
+</div>
+
+<div id="content">
+
+    <h2>write.lua</h2>
+<pre>
+<span class="comment">-- setup path to find the project source files of Pegasus
+</span><span class="global">package</span>.path = <span class="string">"./src/?.lua;./src/?/init.lua;"</span>..<span class="global">package</span>.path
+
+<span class="keyword">local</span> Pegasus = <span class="global">require</span> <span class="string">'pegasus'</span>
+
+<span class="keyword">local</span> server = Pegasus:<span class="function-name">new</span>()
+
+server:<span class="function-name">start</span>(<span class="keyword">function</span> (req, res)
+  res:<span class="function-name">addHeader</span>(<span class="string">'Content-Type'</span>, <span class="string">'text/html'</span>):<span class="function-name">write</span>(<span class="string">'hello pegasus world!'</span>)
+
+  <span class="comment">-- return a truthy value to indicate the request was handled, no further handling needed
+</span>  <span class="keyword">return</span> res:<span class="function-name">close</span>()
+<span class="keyword">end</span>)</pre>
+
+
+</div> <!-- id="content" -->
+</div> <!-- id="main" -->
+<div id="about">
+<i>generated by <a href="http://github.com/lunarmodules/ldoc">LDoc 1.5.0</a></i>
+<i style="float:right;">Last updated 2026-03-30 13:29:33 </i>
+</div> <!-- id="about" -->
+</div> <!-- id="container" -->
+</body>
+</html>
diff --git a/docs/index.html b/docs/index.html
new file mode 100644
index 0000000..979b882
--- /dev/null
+++ b/docs/index.html
@@ -0,0 +1,159 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+<head>
+    <title>Pegasus webserver in Lua</title>
+    <link rel="stylesheet" href="ldoc.css" type="text/css" />
+</head>
+<body>
+
+<div id="container">
+
+<div id="product">
+	<div id="product_logo"></div>
+	<div id="product_name"><big><b></b></big></div>
+	<div id="product_description"></div>
+</div> <!-- id="product" -->
+
+
+<div id="main">
+
+
+<!-- Menu -->
+
+<div id="navigation">
+<br/>
+<h1>Pegasus</h1>
+
+
+
+
+
+<h2>Modules</h2>
+<ul class="nowrap">
+  <li><a href="modules/logging.html">logging</a></li>
+</ul>
+<h2>Classes</h2>
+<ul class="nowrap">
+  <li><a href="classes/pegasus.html">pegasus</a></li>
+  <li><a href="classes/pegasus.handler.html">pegasus.handler</a></li>
+  <li><a href="classes/pegasus.plugins.compress.html">pegasus.plugins.compress</a></li>
+  <li><a href="classes/pegasus.plugins.downloads.html">pegasus.plugins.downloads</a></li>
+  <li><a href="classes/pegasus.plugins.files.html">pegasus.plugins.files</a></li>
+  <li><a href="classes/pegasus.plugins.router.html">pegasus.plugins.router</a></li>
+  <li><a href="classes/pegasus.plugins.tls.html">pegasus.plugins.tls</a></li>
+  <li><a href="classes/pegasus.request.html">pegasus.request</a></li>
+  <li><a href="classes/pegasus.response.html">pegasus.response</a></li>
+</ul>
+<h2>Topics</h2>
+<ul class="">
+  <li><a href="topics/LICENSE.html">LICENSE</a></li>
+  <li><a href="topics/README.md.html">README</a></li>
+</ul>
+<h2>Examples</h2>
+<ul class="nowrap">
+  <li><a href="examples/app.lua.html">app.lua</a></li>
+  <li><a href="examples/app_stream.lua.html">app_stream.lua</a></li>
+  <li><a href="examples/copas.lua.html">copas.lua</a></li>
+  <li><a href="examples/querystring.lua.html">querystring.lua</a></li>
+  <li><a href="examples/write.lua.html">write.lua</a></li>
+</ul>
+
+</div>
+
+<div id="content">
+
+
+  <h2>Minimal, embeddable HTTP server with a simple plugin system.</h2>
+
+<h2>Modules</h2>
+<table class="module_list">
+	<tr>
+		<td class="name" nowrap><a href="modules/logging.html">logging</a></td>
+		<td class="summary">logging.</td>
+	</tr>
+</table>
+<h2>Classes</h2>
+<table class="module_list">
+	<tr>
+		<td class="name" nowrap><a href="classes/pegasus.html">pegasus</a></td>
+		<td class="summary">The Pegasus server main entry point.</td>
+	</tr>
+	<tr>
+		<td class="name" nowrap><a href="classes/pegasus.handler.html">pegasus.handler</a></td>
+		<td class="summary">Internal handler that drives the request/response cycle.</td>
+	</tr>
+	<tr>
+		<td class="name" nowrap><a href="classes/pegasus.plugins.compress.html">pegasus.plugins.compress</a></td>
+		<td class="summary">gzip compression for responses.</td>
+	</tr>
+	<tr>
+		<td class="name" nowrap><a href="classes/pegasus.plugins.downloads.html">pegasus.plugins.downloads</a></td>
+		<td class="summary">Plugin that sends files downstream as downloads.</td>
+	</tr>
+	<tr>
+		<td class="name" nowrap><a href="classes/pegasus.plugins.files.html">pegasus.plugins.files</a></td>
+		<td class="summary">Plugin that serves static content.</td>
+	</tr>
+	<tr>
+		<td class="name" nowrap><a href="classes/pegasus.plugins.router.html">pegasus.plugins.router</a></td>
+		<td class="summary">A router plugin for handling paths/methods/path-parameters.</td>
+	</tr>
+	<tr>
+		<td class="name" nowrap><a href="classes/pegasus.plugins.tls.html">pegasus.plugins.tls</a></td>
+		<td class="summary">Implements TLS for secure connections.</td>
+	</tr>
+	<tr>
+		<td class="name" nowrap><a href="classes/pegasus.request.html">pegasus.request</a></td>
+		<td class="summary">Request object available in callback handlers.</td>
+	</tr>
+	<tr>
+		<td class="name" nowrap><a href="classes/pegasus.response.html">pegasus.response</a></td>
+		<td class="summary">Response object available in callback handlers.</td>
+	</tr>
+</table>
+<h2>Topics</h2>
+<table class="module_list">
+	<tr>
+		<td class="name" nowrap><a href="topics/LICENSE.html">LICENSE</a></td>
+		<td class="summary"></td>
+	</tr>
+	<tr>
+		<td class="name" nowrap><a href="topics/README.md.html">README.md</a></td>
+		<td class="summary"></td>
+	</tr>
+</table>
+<h2>Examples</h2>
+<table class="module_list">
+	<tr>
+		<td class="name" nowrap><a href="examples/app.lua.html">app.lua</a></td>
+		<td class="summary"></td>
+	</tr>
+	<tr>
+		<td class="name" nowrap><a href="examples/app_stream.lua.html">app_stream.lua</a></td>
+		<td class="summary"></td>
+	</tr>
+	<tr>
+		<td class="name" nowrap><a href="examples/copas.lua.html">copas.lua</a></td>
+		<td class="summary"></td>
+	</tr>
+	<tr>
+		<td class="name" nowrap><a href="examples/querystring.lua.html">querystring.lua</a></td>
+		<td class="summary"></td>
+	</tr>
+	<tr>
+		<td class="name" nowrap><a href="examples/write.lua.html">write.lua</a></td>
+		<td class="summary"></td>
+	</tr>
+</table>
+
+</div> <!-- id="content" -->
+</div> <!-- id="main" -->
+<div id="about">
+<i>generated by <a href="http://github.com/lunarmodules/ldoc">LDoc 1.5.0</a></i>
+<i style="float:right;">Last updated 2026-03-30 13:29:33 </i>
+</div> <!-- id="about" -->
+</div> <!-- id="container" -->
+</body>
+</html>
diff --git a/docs/ldoc.css b/docs/ldoc.css
new file mode 100644
index 0000000..df2c98f
--- /dev/null
+++ b/docs/ldoc.css
@@ -0,0 +1,618 @@
+/* Pegasus LDoc — modern documentation theme (CSS only) */
+:root {
+    --bg-page: #f4f6f9;
+    --bg-surface: #ffffff;
+    --bg-sidebar: #fafbfc;
+    --border: #e2e8f0;
+    --border-strong: #cbd5e1;
+    --text: #1e293b;
+    --text-muted: #64748b;
+    --accent: #2563eb;
+    --accent-hover: #1d4ed8;
+    --accent-soft: rgba(37, 99, 235, 0.08);
+    --accent-ring: rgba(37, 99, 235, 0.35);
+    --header-ink: #0f172a;
+    --radius: 10px;
+    --radius-sm: 6px;
+    --shadow: 0 1px 3px rgba(15, 23, 42, 0.06);
+    --shadow-md: 0 4px 24px rgba(15, 23, 42, 0.08);
+    --font-sans: ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto,
+        "Helvetica Neue", Arial, sans-serif;
+    --font-mono: ui-monospace, "SF Mono", "Cascadia Code", "Source Code Pro",
+        Menlo, Consolas, monospace;
+}
+
+*,
+*::before,
+*::after {
+    box-sizing: border-box;
+}
+
+html {
+    scroll-behavior: smooth;
+}
+
+body {
+    margin: 0;
+    color: var(--text);
+    font-size: 16px;
+    line-height: 1.6;
+    font-family: var(--font-sans);
+    background: var(--bg-page);
+    -webkit-font-smoothing: antialiased;
+}
+
+#product {
+    display: none;
+}
+
+#container {
+    min-height: 100vh;
+    display: flex;
+    flex-direction: column;
+}
+
+#main {
+    display: flex;
+    flex: 1;
+    align-items: flex-start;
+    width: 100%;
+}
+
+a:link,
+a:visited {
+    color: var(--accent);
+    text-decoration-skip-ink: auto;
+}
+
+a:hover {
+    color: var(--accent-hover);
+    text-decoration: underline;
+    text-underline-offset: 2px;
+}
+
+h1 {
+    font-size: 1.75rem;
+    font-weight: 650;
+    letter-spacing: -0.02em;
+    color: var(--header-ink);
+}
+
+h2 {
+    font-size: 1.35rem;
+    font-weight: 600;
+    letter-spacing: -0.015em;
+    color: var(--header-ink);
+}
+
+h3 {
+    font-size: 1.125rem;
+    font-weight: 600;
+    color: var(--header-ink);
+}
+
+h4 {
+    font-size: 1rem;
+    font-weight: 600;
+    color: var(--header-ink);
+}
+
+hr {
+    height: 1px;
+    background: var(--border);
+    border: 0;
+    margin: 1.25rem 0;
+}
+
+code,
+tt {
+    font-family: var(--font-mono);
+    font-size: 0.9em;
+    background: var(--accent-soft);
+    color: var(--header-ink);
+    padding: 0.15em 0.4em;
+    border-radius: 4px;
+}
+
+#content h1 code {
+    background: rgba(255, 255, 255, 0.15);
+    color: inherit;
+    padding: 0.1em 0.35em;
+}
+
+span.parameter {
+    font-family: var(--font-mono);
+    font-weight: 600;
+    color: var(--text-muted);
+}
+
+span.parameter::after {
+    content: ":";
+}
+
+span.types::before {
+    content: "(";
+}
+
+span.types::after {
+    content: ")";
+}
+
+.type {
+    font-weight: 600;
+    font-style: italic;
+    color: var(--text-muted);
+}
+
+p.name {
+    font-family: var(--font-mono);
+    font-size: 0.95em;
+}
+
+#navigation {
+    float: none;
+    flex: 0 0 min(17rem, 42vw);
+    max-width: 17rem;
+    vertical-align: top;
+    overflow: visible;
+    background:
+        linear-gradient(180deg, rgba(37, 99, 235, 0.06), rgba(37, 99, 235, 0))
+            0 0 / 100% 240px no-repeat,
+        var(--bg-sidebar);
+    border-right: 1px solid var(--border);
+    box-shadow: var(--shadow);
+    position: sticky;
+    top: 0;
+    align-self: stretch;
+    max-height: 100vh;
+    overflow-y: auto;
+}
+
+#navigation br {
+    display: none;
+}
+
+#navigation h1 {
+    margin: 0;
+    padding: 1.25rem 1.25rem 1rem;
+    font-size: 1.1rem;
+    font-weight: 700;
+    letter-spacing: -0.02em;
+    color: var(--header-ink);
+    background: transparent;
+    border-bottom: 1px solid var(--border);
+}
+
+#navigation h2 {
+    font-size: 0.7rem;
+    font-weight: 700;
+    text-transform: uppercase;
+    letter-spacing: 0.08em;
+    color: var(--text-muted);
+    background: transparent;
+    border-bottom: none;
+    padding: 1.25rem 1.25rem 0.5rem;
+    margin: 0;
+}
+
+#navigation ul + h2 {
+    border-top: 1px dashed var(--border);
+    margin-top: 0.25rem;
+}
+
+#content {
+    float: none;
+    margin-left: 0;
+    flex: 1;
+    min-width: 0;
+    background: var(--bg-surface);
+    border-radius: 0;
+    box-shadow: var(--shadow-md);
+}
+
+#content h1 {
+    margin: 0;
+    padding: 1.35rem 1.5rem;
+    background: linear-gradient(135deg, #1e3a5f 0%, #0f172a 100%);
+    color: #f8fafc;
+    font-weight: 650;
+    letter-spacing: -0.02em;
+    border-bottom: 1px solid rgba(255, 255, 255, 0.06);
+}
+
+#content h2 {
+    margin: 0;
+    padding: 0.85rem 1.5rem;
+    background: var(--bg-page);
+    color: var(--header-ink);
+    font-weight: 600;
+    font-size: 1.15rem;
+    border-bottom: 1px solid var(--border);
+    border-top: 1px solid var(--border);
+}
+
+#content h2:first-of-type {
+    border-top: none;
+}
+
+#content h2 a {
+    background: transparent;
+    color: inherit;
+    text-decoration: none;
+}
+
+#content h2 a:hover {
+    color: var(--accent);
+    text-decoration: none;
+}
+
+#content h3 {
+    font-style: normal;
+    margin: 1.5rem 1.5rem 0.5rem;
+    padding: 0 0 0.5rem;
+    border-bottom: 2px solid var(--border);
+    color: var(--header-ink);
+}
+
+#content h4 {
+    margin: 1.25rem 1.5rem 0.35rem;
+    padding: 0 0 0.35rem;
+    border-bottom: 1px solid var(--border);
+}
+
+#content pre {
+    margin: 1rem 1.5rem;
+}
+
+pre code {
+    background: transparent;
+    padding: 0;
+    color: inherit;
+    font-size: inherit;
+    border-radius: 0;
+}
+
+pre {
+    background: #1a1d26;
+    color: #e2e8f0;
+    border-radius: var(--radius);
+    padding: 1rem 1.15rem;
+    overflow: auto;
+    font-family: var(--font-mono);
+    font-size: 0.875rem;
+    line-height: 1.55;
+    border: 1px solid rgba(255, 255, 255, 0.06);
+    box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.04);
+}
+
+#content ul pre.example {
+    margin-left: 0;
+}
+
+table.index {
+    width: 100%;
+}
+
+table.index td {
+    text-align: left;
+    vertical-align: top;
+}
+
+#navigation ul {
+    font-size: 0.9375rem;
+    list-style: none;
+    margin: 0 0 0.75rem;
+    padding: 0.25rem 0.75rem 0.75rem;
+}
+
+#navigation li {
+    text-indent: 0;
+    display: block;
+    margin: 0.125rem 0;
+}
+
+#navigation li a {
+    position: relative;
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+    padding: 0.4rem 0.7rem;
+    border-radius: 10px;
+    color: var(--text);
+    text-decoration: none;
+    border: 1px solid transparent;
+    transition: background-color 0.15s ease, border-color 0.15s ease,
+        transform 0.05s ease;
+}
+
+#navigation li a:hover {
+    text-decoration: none;
+    background: var(--accent-soft);
+    border-color: rgba(37, 99, 235, 0.18);
+    transform: translateY(-1px);
+}
+
+#navigation li a:focus-visible {
+    outline: none;
+    box-shadow: 0 0 0 3px var(--accent-ring);
+}
+
+#navigation li li a {
+    margin: 0;
+}
+
+/* Current page: LDoc renders it as <strong> inside the list */
+#navigation li strong {
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+    padding: 0.4rem 0.7rem;
+    border-radius: 10px;
+    border: 1px solid transparent;
+    background: rgba(37, 99, 235, 0.08);
+    color: var(--accent-hover);
+    font-weight: 700;
+    box-shadow: inset 3px 0 0 rgba(37, 99, 235, 0.55);
+}
+
+#content p {
+    padding-left: 1.5rem;
+    padding-right: 1.5rem;
+}
+
+#content table {
+    padding-left: 1.5rem;
+    padding-right: 1.5rem;
+    background: transparent;
+}
+
+#content p,
+#content table,
+#content ol,
+#content ul,
+#content dl {
+    max-width: 52rem;
+}
+
+#about {
+    padding: 1rem 1.5rem;
+    padding-left: 1.5rem;
+    background: var(--bg-surface);
+    border-top: 1px solid var(--border);
+    color: var(--text-muted);
+    font-size: 0.875rem;
+}
+
+#about a {
+    color: var(--accent);
+}
+
+table.module_list,
+table.function_list {
+    border-collapse: separate;
+    border-spacing: 0;
+    margin: 1rem 1.5rem;
+    width: calc(100% - 3rem);
+    max-width: 52rem;
+    border: 1px solid var(--border);
+    border-radius: var(--radius);
+    overflow: hidden;
+    box-shadow: var(--shadow);
+}
+
+table.module_list tr:nth-child(even) td,
+table.function_list tr:nth-child(even) td {
+    background: #f8fafc;
+}
+
+table.module_list td,
+table.function_list td {
+    padding: 0.65rem 1rem;
+    border: none;
+    border-bottom: 1px solid var(--border);
+    vertical-align: top;
+}
+
+table.module_list tr:last-child td,
+table.function_list tr:last-child td {
+    border-bottom: none;
+}
+
+table.module_list td.name,
+table.function_list td.name {
+    background: transparent;
+    min-width: 200px;
+    border-right: 1px solid var(--border);
+    font-family: var(--font-mono);
+    font-size: 0.9em;
+}
+
+table.module_list td.summary,
+table.function_list td.summary {
+    background: transparent;
+    width: 100%;
+    color: var(--text-muted);
+}
+
+dl.function {
+    margin: 1rem 1.5rem 1.5rem;
+    border: none;
+    border-radius: 0;
+    background: transparent;
+    box-shadow: none;
+    overflow: visible;
+}
+
+dl.function dt {
+    color: var(--accent);
+    font-family: var(--font-mono);
+    font-size: 0.9em;
+    border: 1px solid var(--border);
+    border-bottom: none;
+    border-radius: var(--radius) var(--radius) 0 0;
+    padding: 0.9rem 1.15rem;
+    background: linear-gradient(180deg, #f8fafc 0%, #fff 100%);
+    box-shadow: var(--shadow);
+    margin-top: 1rem;
+}
+
+dl.function dt:first-child {
+    margin-top: 0;
+}
+
+dl.function dd {
+    margin: 0;
+    padding: 0.75rem 1.15rem 1.25rem;
+    border: 1px solid var(--border);
+    border-top: none;
+    border-radius: 0 0 var(--radius) var(--radius);
+    background: var(--bg-surface);
+    box-shadow: var(--shadow);
+    margin-bottom: 1rem;
+}
+
+#content dl.function dd h3 {
+    margin: 1.05rem 0 0.55rem;
+    padding: 0.85rem 0 0;
+    font-size: 0.9rem;
+    font-weight: 700;
+    letter-spacing: 0.02em;
+    text-transform: uppercase;
+    color: var(--text-muted);
+    border-top: 1px solid var(--border);
+}
+
+#content dl.function dd ul,
+#content dl.function dd ol {
+    margin: 0.25rem 0 0.75rem;
+    padding: 0;
+    padding-left: 1.25rem;
+    list-style-type: none;
+}
+
+ul.nowrap {
+    overflow: auto;
+    white-space: nowrap;
+}
+
+.section-description {
+    padding-left: 1.5rem;
+    padding-right: 1.5rem;
+}
+
+ul ul,
+ol ul,
+ol ol,
+ul ol {
+    margin-top: 0;
+}
+
+a:target + * {
+    background-color: #fef9c3;
+    box-shadow: inset 3px 0 0 0 #eab308;
+    border-radius: 0 var(--radius-sm) var(--radius-sm) 0;
+    padding-left: 0.35rem;
+    margin-left: -0.35rem;
+    transition: background-color 0.2s ease;
+}
+
+/* Syntax highlighting (prettify) */
+pre .comment {
+    color: #94a3b8;
+    font-style: italic;
+}
+
+pre .constant {
+    color: #fbbf24;
+}
+
+pre .escape {
+    color: #f472b6;
+}
+
+pre .keyword {
+    color: #c084fc;
+    font-weight: 600;
+}
+
+pre .library {
+    color: #5eead4;
+}
+
+pre .marker {
+    color: #1e293b;
+    background: #fde047;
+    font-weight: 600;
+    padding: 0 0.15em;
+    border-radius: 3px;
+}
+
+pre .string {
+    color: #86efac;
+}
+
+pre .number {
+    color: #fdba74;
+}
+
+pre .operator {
+    color: #93c5fd;
+    font-weight: 600;
+}
+
+pre .preprocessor,
+pre .prepro {
+    color: #fb923c;
+}
+
+pre .global {
+    color: #e879f9;
+}
+
+pre .user-keyword {
+    color: #d8b4fe;
+}
+
+pre .prompt {
+    color: #4ade80;
+}
+
+pre .url {
+    color: #7dd3fc;
+    text-decoration: underline;
+}
+
+pre .function-name {
+    color: #7dd3fc;
+}
+
+@media (max-width: 768px) {
+    #main {
+        flex-direction: column;
+    }
+
+    #navigation {
+        position: relative;
+        max-height: none;
+        flex: none;
+        width: 100%;
+        max-width: none;
+        border-right: none;
+        border-bottom: 1px solid var(--border);
+    }
+
+    #content p,
+    #content table,
+    #content ol,
+    #content ul,
+    #content dl {
+        max-width: none;
+    }
+
+    table.module_list,
+    table.function_list {
+        width: calc(100% - 2rem);
+        margin-left: 1rem;
+        margin-right: 1rem;
+    }
+}
diff --git a/docs/modules/logging.html b/docs/modules/logging.html
new file mode 100644
index 0000000..d536082
--- /dev/null
+++ b/docs/modules/logging.html
@@ -0,0 +1,92 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+<head>
+    <title>Pegasus webserver in Lua</title>
+    <link rel="stylesheet" href="../ldoc.css" type="text/css" />
+</head>
+<body>
+
+<div id="container">
+
+<div id="product">
+	<div id="product_logo"></div>
+	<div id="product_name"><big><b></b></big></div>
+	<div id="product_description"></div>
+</div> <!-- id="product" -->
+
+
+<div id="main">
+
+
+<!-- Menu -->
+
+<div id="navigation">
+<br/>
+<h1>Pegasus</h1>
+
+
+<ul>
+  <li><a href="../index.html">Index</a></li>
+</ul>
+
+
+
+<h2>Modules</h2>
+<ul class="nowrap">
+  <li><strong>logging</strong></li>
+</ul>
+<h2>Classes</h2>
+<ul class="nowrap">
+  <li><a href="../classes/pegasus.html">pegasus</a></li>
+  <li><a href="../classes/pegasus.handler.html">pegasus.handler</a></li>
+  <li><a href="../classes/pegasus.plugins.compress.html">pegasus.plugins.compress</a></li>
+  <li><a href="../classes/pegasus.plugins.downloads.html">pegasus.plugins.downloads</a></li>
+  <li><a href="../classes/pegasus.plugins.files.html">pegasus.plugins.files</a></li>
+  <li><a href="../classes/pegasus.plugins.router.html">pegasus.plugins.router</a></li>
+  <li><a href="../classes/pegasus.plugins.tls.html">pegasus.plugins.tls</a></li>
+  <li><a href="../classes/pegasus.request.html">pegasus.request</a></li>
+  <li><a href="../classes/pegasus.response.html">pegasus.response</a></li>
+</ul>
+<h2>Topics</h2>
+<ul class="">
+  <li><a href="../topics/LICENSE.html">LICENSE</a></li>
+  <li><a href="../topics/README.md.html">README</a></li>
+</ul>
+<h2>Examples</h2>
+<ul class="nowrap">
+  <li><a href="../examples/app.lua.html">app.lua</a></li>
+  <li><a href="../examples/app_stream.lua.html">app_stream.lua</a></li>
+  <li><a href="../examples/copas.lua.html">copas.lua</a></li>
+  <li><a href="../examples/querystring.lua.html">querystring.lua</a></li>
+  <li><a href="../examples/write.lua.html">write.lua</a></li>
+</ul>
+
+</div>
+
+<div id="content">
+
+<h1>Module <code>logging</code></h1>
+<p>logging.</p>
+<p> Requiring this module returns a LuaLogging compatible logger object.
+ If LuaLogging was already loaded, it returns the defaultlogger,
+ otherwise returns a stub. The stub has only no-op functions.</p>
+
+
+
+<br/>
+<br/>
+
+
+
+
+</div> <!-- id="content" -->
+</div> <!-- id="main" -->
+<div id="about">
+<i>generated by <a href="http://github.com/lunarmodules/ldoc">LDoc 1.5.0</a></i>
+<i style="float:right;">Last updated 2026-03-30 13:29:33 </i>
+</div> <!-- id="about" -->
+</div> <!-- id="container" -->
+</body>
+</html>
diff --git a/docs/topics/LICENSE.html b/docs/topics/LICENSE.html
new file mode 100644
index 0000000..79d2227
--- /dev/null
+++ b/docs/topics/LICENSE.html
@@ -0,0 +1,100 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+<head>
+    <title>Pegasus webserver in Lua</title>
+    <link rel="stylesheet" href="../ldoc.css" type="text/css" />
+</head>
+<body>
+
+<div id="container">
+
+<div id="product">
+	<div id="product_logo"></div>
+	<div id="product_name"><big><b></b></big></div>
+	<div id="product_description"></div>
+</div> <!-- id="product" -->
+
+
+<div id="main">
+
+
+<!-- Menu -->
+
+<div id="navigation">
+<br/>
+<h1>Pegasus</h1>
+
+
+<ul>
+  <li><a href="../index.html">Index</a></li>
+</ul>
+
+
+
+<h2>Topics</h2>
+<ul class="">
+  <li><strong>LICENSE</strong></li>
+  <li><a href="../topics/README.md.html">README</a></li>
+</ul>
+<h2>Modules</h2>
+<ul class="nowrap">
+  <li><a href="../modules/logging.html">logging</a></li>
+</ul>
+<h2>Classes</h2>
+<ul class="nowrap">
+  <li><a href="../classes/pegasus.html">pegasus</a></li>
+  <li><a href="../classes/pegasus.handler.html">pegasus.handler</a></li>
+  <li><a href="../classes/pegasus.plugins.compress.html">pegasus.plugins.compress</a></li>
+  <li><a href="../classes/pegasus.plugins.downloads.html">pegasus.plugins.downloads</a></li>
+  <li><a href="../classes/pegasus.plugins.files.html">pegasus.plugins.files</a></li>
+  <li><a href="../classes/pegasus.plugins.router.html">pegasus.plugins.router</a></li>
+  <li><a href="../classes/pegasus.plugins.tls.html">pegasus.plugins.tls</a></li>
+  <li><a href="../classes/pegasus.request.html">pegasus.request</a></li>
+  <li><a href="../classes/pegasus.response.html">pegasus.response</a></li>
+</ul>
+<h2>Examples</h2>
+<ul class="nowrap">
+  <li><a href="../examples/app.lua.html">app.lua</a></li>
+  <li><a href="../examples/app_stream.lua.html">app_stream.lua</a></li>
+  <li><a href="../examples/copas.lua.html">copas.lua</a></li>
+  <li><a href="../examples/querystring.lua.html">querystring.lua</a></li>
+  <li><a href="../examples/write.lua.html">write.lua</a></li>
+</ul>
+
+</div>
+
+<div id="content">
+
+    The MIT License (MIT)</p>
+
+<p>Copyright (c) 2016 Evandro Leopoldino Gonçalves</p>
+
+<p>Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:</p>
+
+<p>The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.</p>
+
+<p>THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+</div> <!-- id="content" -->
+</div> <!-- id="main" -->
+<div id="about">
+<i>generated by <a href="http://github.com/lunarmodules/ldoc">LDoc 1.5.0</a></i>
+<i style="float:right;">Last updated 2026-03-30 13:29:33 </i>
+</div> <!-- id="about" -->
+</div> <!-- id="container" -->
+</body>
+</html>
diff --git a/docs/topics/README.md.html b/docs/topics/README.md.html
new file mode 100644
index 0000000..ccf2fe7
--- /dev/null
+++ b/docs/topics/README.md.html
@@ -0,0 +1,315 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+<head>
+    <title>Pegasus webserver in Lua</title>
+    <link rel="stylesheet" href="../ldoc.css" type="text/css" />
+</head>
+<body>
+
+<div id="container">
+
+<div id="product">
+	<div id="product_logo"></div>
+	<div id="product_name"><big><b></b></big></div>
+	<div id="product_description"></div>
+</div> <!-- id="product" -->
+
+
+<div id="main">
+
+
+<!-- Menu -->
+
+<div id="navigation">
+<br/>
+<h1>Pegasus</h1>
+
+
+<ul>
+  <li><a href="../index.html">Index</a></li>
+</ul>
+
+<h2>Contents</h2>
+<ul>
+<li><a href="#Installation">Installation </a></li>
+<li><a href="#How_does_it_work_">How does it work? </a></li>
+<li><a href="#Features">Features </a></li>
+<li><a href="#API">API </a></li>
+<li><a href="#Native_Plugin">Native Plugin </a></li>
+<li><a href="#Contributing">Contributing </a></li>
+</ul>
+
+
+<h2>Topics</h2>
+<ul class="">
+  <li><a href="../topics/LICENSE.html">LICENSE</a></li>
+  <li><strong>README</strong></li>
+</ul>
+<h2>Modules</h2>
+<ul class="nowrap">
+  <li><a href="../modules/logging.html">logging</a></li>
+</ul>
+<h2>Classes</h2>
+<ul class="nowrap">
+  <li><a href="../classes/pegasus.html">pegasus</a></li>
+  <li><a href="../classes/pegasus.handler.html">pegasus.handler</a></li>
+  <li><a href="../classes/pegasus.plugins.compress.html">pegasus.plugins.compress</a></li>
+  <li><a href="../classes/pegasus.plugins.downloads.html">pegasus.plugins.downloads</a></li>
+  <li><a href="../classes/pegasus.plugins.files.html">pegasus.plugins.files</a></li>
+  <li><a href="../classes/pegasus.plugins.router.html">pegasus.plugins.router</a></li>
+  <li><a href="../classes/pegasus.plugins.tls.html">pegasus.plugins.tls</a></li>
+  <li><a href="../classes/pegasus.request.html">pegasus.request</a></li>
+  <li><a href="../classes/pegasus.response.html">pegasus.response</a></li>
+</ul>
+<h2>Examples</h2>
+<ul class="nowrap">
+  <li><a href="../examples/app.lua.html">app.lua</a></li>
+  <li><a href="../examples/app_stream.lua.html">app_stream.lua</a></li>
+  <li><a href="../examples/copas.lua.html">copas.lua</a></li>
+  <li><a href="../examples/querystring.lua.html">querystring.lua</a></li>
+  <li><a href="../examples/write.lua.html">write.lua</a></li>
+</ul>
+
+</div>
+
+<div id="content">
+
+
+<p><a href="http://evandrolg.github.io/pegasus.lua"><img src="http://evandrolg.github.io/pegasus.lua/pegasus.lua.svg" alt="pegasus.lua"/></a></p>
+
+<p>An http server to work with web applications written in Lua language <a href="https://evandrolg.github.io/pegasus.lua">check the site</a>.</p>
+
+<p><a href="https://github.com/EvandroLG/pegasus.lua/actions/workflows/unix_build.yml"><img src="https://img.shields.io/github/actions/workflow/status/EvandroLG/pegasus.lua/unix_build.yml?branch=master&amp;label=Unix%20build&amp;logo=linux" alt="Unix build"/></a>
+<a href="https://github.com/EvandroLG/pegasus.lua/actions/workflows/lint.yml"><img src="https://github.com/EvandroLG/pegasus.lua/workflows/Lint/badge.svg" alt="Lint"/></a>
+<a href="https://huboard.com/EvandroLG/pegasus.lua"><img src="http://img.shields.io/badge/Hu-Board-7965cc.svg" alt="HuBoard
+badge"/></a>
+<a href="https://gitter.im/EvandroLG/pegasus.lua?utm_source=badge&amp;utm_medium=badge&amp;utm_campaign=pr-badge&amp;utm_content=badge"><img src="https://badges.gitter.im/Join%20Chat.svg" alt="Gitter"/></a></p>
+
+<p><a name="Installation"></a></p>
+<h2>Installation</h2>
+
+<p>To install Pegasus.lua, run:</p>
+
+
+<pre>
+$ luarocks install pegasus
+</pre>
+
+
+<p><a name="How_does_it_work_"></a></p>
+<h2>How does it work?</h2>
+
+<p>Follow an example:</p>
+
+
+<pre>
+<span class="keyword">local</span> pegasus = <span class="global">require</span> <span class="string">'pegasus'</span>
+
+<span class="keyword">local</span> server = pegasus:<span class="function-name">new</span>({
+  port=<span class="string">'9090'</span>,
+  location=<span class="string">'example/root'</span>
+})
+
+server:<span class="function-name">start</span>(<span class="keyword">function</span> (request, response)
+  <span class="global">print</span> <span class="string">"It's running..."</span>
+<span class="keyword">end</span>)
+</pre>
+
+
+<p>Or try the <a href="example/README.md">included examples</a>.</p>
+
+<p><a name="Features"></a></p>
+<h2>Features</h2>
+
+<ul>
+    <li>Compatible with Linux, Mac and Windows systems</li>
+    <li>Easy API</li>
+    <li>Support Lua >= 5.1</li>
+    <li>Native support for HTTP Streaming, aka chunked responses. <a href="https://github.com/EvandroLG/pegasus.lua/blob/master/example/app_stream.lua">Check how it works</a>.</li>
+    <li>Native plugin to compress responses using the "gzip" method</li>
+</ul>
+
+<p><a name="API"></a></p>
+<h2>API</h2>
+
+<h3>Parameters</h3>
+
+<ul>
+    <li><code>host:string</code> Host address where the application will run. By default it uses <code>localhost</code></li>
+    <li><code>port:string</code> The port where the application will run. By default it's <code>9090</code></li>
+    <li><code>location:string</code> Path used by Pegasus to search for the files. By default it's the root</li>
+    <li><code>plugins:table</code> List with plugins</li>
+    <li><code>timeout:number</code> It's a timeout for estabilishing a connection with the server</li>
+</ul>
+
+<h3>Request</h3>
+
+<h4>Properties</h4>
+
+<ul>
+    <li><code>path:string</code> A string with the request path</li>
+    <li><code>headers:table</code> A table with all the headers data</li>
+    <li><code>method:function</code> The output is the request method as a string ('GET', 'POST', etc)</li>
+    <li><code>querystring:string</code> It returns a dictionary with all the GET parameters</li>
+    <li><code>ip:string</code> It returns the client's ip</li>
+    <li><code>port:number</code> It returns the port where Pegasus is running</li>
+</ul>
+
+<h3>Response</h3>
+
+<h4>Methods</h4>
+
+<ul>
+    <li><code>addHeader(string:key, string:value)</code> Adds a new header</li>
+    <li><code>addHeaders(table:headers)</code> It adds news headers</li>
+    <li><code>statusCode(number:statusCode, string:statusMessage)</code> It adds a Status Code</li>
+    <li><code>contentType(string:value)</code> Adds a value to Content-Type field</li>
+    <li><code>write(string:body)</code> It creates the body with the value passed as
+    parameter</li>
+    <li><code>writeDefaultErrorMessage(statusCode: string, message:body)</code> It sets an HTTP status code and writes an error message to the response</li>
+    <li><code>writeFile(string:file)</code> It creates the body with the content of the
+    file passed as parameter</li>
+    <li><code>post():table</code> It returns a dictionary with all the POST parameters</li>
+    <li><code>redirect(location:string, temporary:boolean):</code> Makes an HTTP redirect to a new location. The status code is set to 302 if temporary is true and false otherwise.</li>
+</ul>
+
+
+<pre>
+<span class="keyword">local</span> pegasus = <span class="global">require</span> <span class="string">'pegasus'</span>
+
+<span class="keyword">local</span> server = pegasus:<span class="function-name">new</span>({ port=<span class="string">'9090'</span> })
+
+server:<span class="function-name">start</span>(<span class="keyword">function</span> (req, rep)
+  rep:<span class="function-name">addHeader</span>(<span class="string">'Date'</span>, <span class="string">'Mon, 15 Jun 2015 14:24:53 GMT'</span>):<span class="function-name">write</span>(<span class="string">'hello pegasus world!'</span>)
+  <span class="keyword">return</span> rep:<span class="function-name">close</span>()
+<span class="keyword">end</span>)
+</pre>
+
+
+<p><a name="Native_Plugin"></a></p>
+<h2>Native Plugin</h2>
+
+<ul>
+    <li>pegasus.plugins.compress</li>
+</ul>
+
+
+<pre>
+<span class="keyword">local</span> Pegasus = <span class="global">require</span> <span class="string">'pegasus'</span>
+<span class="keyword">local</span> Compress = <span class="global">require</span> <span class="string">'pegasus.plugins.compress'</span>
+
+<span class="keyword">local</span> server = Pegasus:<span class="function-name">new</span>({
+  plugins = { Compress:<span class="function-name">new</span>() }
+})
+
+server:<span class="function-name">start</span>()
+</pre>
+
+
+<ul>
+    <li>pegasus.plugins.downloads</li>
+</ul>
+
+
+<pre>
+<span class="keyword">local</span> Pegasus = <span class="global">require</span> <span class="string">'pegasus'</span>
+<span class="keyword">local</span> Downloads = <span class="global">require</span> <span class="string">'pegasus.plugins.downloads'</span>
+
+<span class="keyword">local</span> server = Pegasus:<span class="function-name">new</span>({
+  plugins = {
+    Downloads:<span class="function-name">new</span> {
+      prefix = <span class="string">"downloads"</span>,
+      stripPrefix = <span class="keyword">true</span>,
+    },
+  }
+})
+
+server:<span class="function-name">start</span>()
+</pre>
+
+
+
+<ul>
+    <li>pegasus.plugins.files</li>
+</ul>
+
+
+<pre>
+<span class="keyword">local</span> Pegasus = <span class="global">require</span> <span class="string">'pegasus'</span>
+<span class="keyword">local</span> Files = <span class="global">require</span> <span class="string">'pegasus.plugins.files'</span>
+
+<span class="keyword">local</span> server = Pegasus:<span class="function-name">new</span>({
+  plugins = {
+    Files:<span class="function-name">new</span> {
+      location = <span class="string">"./"</span>,
+      default = <span class="string">"index.html"</span>,
+    },
+  }
+})
+
+server:<span class="function-name">start</span>()
+</pre>
+
+
+<ul>
+    <li>pegasus.plugins.tls</li>
+</ul>
+
+
+<pre>
+<span class="keyword">local</span> Pegasus = <span class="global">require</span> <span class="string">'pegasus'</span>
+<span class="keyword">local</span> Tls = <span class="global">require</span> <span class="string">'pegasus.plugins.tls'</span>
+
+<span class="keyword">local</span> server = Pegasus:<span class="function-name">new</span>({
+  plugins = {
+    TLS:<span class="function-name">new</span> {
+      wrap = {
+        mode = <span class="string">"server"</span>,
+        protocol = <span class="string">"any"</span>,
+        key = <span class="string">"./serverAkey.pem"</span>,
+        certificate = <span class="string">"./serverA.pem"</span>,
+        cafile = <span class="string">"./rootA.pem"</span>,
+        verify = {<span class="string">"none"</span>},
+        options = {<span class="string">"all"</span>, <span class="string">"no_sslv2"</span>, <span class="string">"no_sslv3"</span>, <span class="string">"no_tlsv1"</span>},
+      },
+      sni = <span class="keyword">nil</span>,
+    },,
+  }
+})
+
+server:<span class="function-name">start</span>()
+</pre>
+
+
+<p><a name="Contributing"></a></p>
+<h2>Contributing</h2>
+
+<h3>Install Dependencies</h3>
+
+
+<pre>
+$ make install_dependencies
+</pre>
+
+
+<h3>Running tests</h3>
+
+
+<pre>
+$ make unit_test
+</pre>
+
+
+
+
+</div> <!-- id="content" -->
+</div> <!-- id="main" -->
+<div id="about">
+<i>generated by <a href="http://github.com/lunarmodules/ldoc">LDoc 1.5.0</a></i>
+<i style="float:right;">Last updated 2026-03-30 13:29:33 </i>
+</div> <!-- id="about" -->
+</div> <!-- id="container" -->
+</body>
+</html>