From d62989413e2475dc74e12e782a6895e9edfbdb13 Mon Sep 17 00:00:00 2001
From: Aapo Talvensaari <aapo.talvensaari@gmail.com>
Date: Tue, 3 Sep 2024 13:05:43 +0300
Subject: [PATCH] chore(*): release 1.1.0

### Summary

#### Added
- `url:decode` method
- `ada.decode` function
- `search:decode` method
- `search:decode_all` method
- `ada.search_encode` function
- `ada.search.encode` function
- `ada.search_decode` function
- `ada.search.decode` function
- `ada.search_decode_all` function
- `ada.search.decode_all` function
#### Changed
- The `set_port` to not allow negative or positive inf or NaN
#### Updated
- The CI is now executed against Ada 2.9.1

Signed-off-by: Aapo Talvensaari <aapo.talvensaari@gmail.com>
---
 CHANGES.md                                    |  17 +-
 docs/classes/search.html                      |  83 ++++++-
 docs/classes/url.html                         | 143 +++++++++++-
 docs/index.html                               |   2 +-
 docs/modules/resty.ada.html                   | 212 +++++++++++++++++-
 docs/modules/resty.ada.search.html            | 162 ++++++++++++-
 lib/resty/ada.lua                             |   2 +-
 ...rockspec => lua-resty-ada-1.1.0-1.rockspec |   4 +-
 8 files changed, 614 insertions(+), 11 deletions(-)
 rename lua-resty-ada-1.0.1-1.rockspec => lua-resty-ada-1.1.0-1.rockspec (95%)

diff --git a/CHANGES.md b/CHANGES.md
index fe4957a..e9aad5e 100644
--- a/CHANGES.md
+++ b/CHANGES.md
@@ -2,11 +2,26 @@
 
 All notable changes to `lua-resty-ada` will be documented in this file.
 
+## [1.1.0] - 2024-09-03
+### Added
+- `url:decode` method
+- `ada.decode` function
+- `ada.search_encode` function
+- `ada.search.encode` function
+- `search:decode` method
+- `search:decode_all` method
+- `ada.search_decode` function
+- `ada.search.decode` function
+- `ada.search_decode_all` function
+- `ada.search.decode_all` function
+### Changed
+- The `set_port` to not allow negative or positive inf or NaN
+### Updated
+- The CI is now executed against Ada 2.9.2
 
 ## [1.0.1] - 2024-08-20
 ### Removed
 - The unnecessary `:is_valid` was removed (the URL is validated when parsed)
-
 ### Added
 - Explicitly free Ada URL object on invalid URLs
 
diff --git a/docs/classes/search.html b/docs/classes/search.html
index f055de7..5d32c1f 100644
--- a/docs/classes/search.html
+++ b/docs/classes/search.html
@@ -34,6 +34,7 @@ <h1>resty.ada</h1>
 
 <h2>Contents</h2>
 <ul>
+<li><a href="#Decode_Methods">Decode Methods </a></li>
 <li><a href="#Has_Methods">Has Methods </a></li>
 <li><a href="#Get_Methods">Get Methods </a></li>
 <li><a href="#Set_Methods">Set Methods </a></li>
@@ -65,6 +66,17 @@ <h1>Class <code>search</code></h1>
 <p> See: <a href="https://url.spec.whatwg.org/#interface-urlsearchparams">https://url.spec.whatwg.org/#interface-urlsearchparams</a></p>
 
 
+<h2><a href="#Decode_Methods">Decode Methods </a></h2>
+<table class="function_list">
+	<tr>
+	<td class="name" nowrap><a href="#search:decode">search:decode ()</a></td>
+	<td class="summary">Decodes search parameters and returns a Lua table of them.</td>
+	</tr>
+	<tr>
+	<td class="name" nowrap><a href="#search:decode">search:decode ()</a></td>
+	<td class="summary">Decodes all search parameters and returns a Lua table of them.</td>
+	</tr>
+</table>
 <h2><a href="#Has_Methods">Has Methods </a></h2>
 <table class="function_list">
 	<tr>
@@ -182,6 +194,75 @@ <h2><a href="#Iterate_Methods">Iterate Methods </a></h2>
 <br/>
 
 
+    <h2 class="section-header "><a name="Decode_Methods"></a>Decode Methods </h2>
+
+    <dl class="function">
+    <dt>
+    <a name = "search:decode"></a>
+    <strong>search:decode ()</strong>
+    </dt>
+    <dd>
+    Decodes search parameters and returns a Lua table of them.</p>
+
+<p> If same parameter appears multiple times, only the value of the
+ first is returned.</p>
+
+<p> An example return value:
+    {
+      key1 = &ldquo;value&rdquo;,
+      key2 = &ldquo;value2&rdquo;,
+    }
+
+
+
+    <h3>Returns:</h3>
+    <ol>
+
+           <span class="types"><a class="type" href="https://www.lua.org/manual/5.1/manual.html#5.5">table</a></span>
+        a table of all search parameters (a string:string map).
+    </ol>
+
+
+
+    <h3>Usage:</h3>
+    <ul>
+        <pre class="example"><span class="keyword">local</span> search = <span class="global">require</span>(<span class="string">"resty.ada.search"</span>).<span class="function-name">parse</span>(<span class="string">"a=b&amp;c=d&amp;e=f&amp;a=g"</span>)
+<span class="keyword">local</span> result = search:<span class="function-name">decode</span>()</pre>
+    </ul>
+
+</dd>
+    <dt>
+    <a name = "search:decode"></a>
+    <strong>search:decode ()</strong>
+    </dt>
+    <dd>
+    Decodes all search parameters and returns a Lua table of them.</p>
+
+<p> An example return value:
+    {
+      key1 = { &ldquo;first&rdquo;, &ldquo;second&rdquo;, },
+      key2 = { &ldquo;value&rdquo; },
+    }
+
+
+
+    <h3>Returns:</h3>
+    <ol>
+
+           <span class="types"><a class="type" href="https://www.lua.org/manual/5.1/manual.html#5.5">table</a></span>
+        a table of all search parameters (a string:table [array] map).
+    </ol>
+
+
+
+    <h3>Usage:</h3>
+    <ul>
+        <pre class="example"><span class="keyword">local</span> search = <span class="global">require</span>(<span class="string">"resty.ada.search"</span>).<span class="function-name">parse</span>(<span class="string">"a=b&amp;a=c&amp;d=e"</span>)
+<span class="keyword">local</span> result = search:<span class="function-name">decode_all</span>()</pre>
+    </ul>
+
+</dd>
+</dl>
     <h2 class="section-header "><a name="Has_Methods"></a>Has Methods </h2>
 
     <dl class="function">
@@ -922,7 +1003,7 @@ <h3>Usage:</h3>
 </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 2024-08-20 21:17:51 </i>
+<i style="float:right;">Last updated 2024-09-03 15:49:45 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/classes/url.html b/docs/classes/url.html
index c0d934f..503546b 100644
--- a/docs/classes/url.html
+++ b/docs/classes/url.html
@@ -34,6 +34,7 @@ <h1>resty.ada</h1>
 
 <h2>Contents</h2>
 <ul>
+<li><a href="#Decode_Methods">Decode Methods </a></li>
 <li><a href="#Has_Methods">Has Methods </a></li>
 <li><a href="#Get_Methods">Get Methods </a></li>
 <li><a href="#Set_Methods">Set Methods </a></li>
@@ -66,6 +67,13 @@ <h1>Class <code>url</code></h1>
 <p> See: <a href="https://url.spec.whatwg.org/#url-representation">https://url.spec.whatwg.org/#url-representation</a></p>
 
 
+<h2><a href="#Decode_Methods">Decode Methods </a></h2>
+<table class="function_list">
+	<tr>
+	<td class="name" nowrap><a href="#url:decode">url:decode ()</a></td>
+	<td class="summary">Decodes URL and return its components in Lua table.</td>
+	</tr>
+</table>
 <h2><a href="#Has_Methods">Has Methods </a></h2>
 <table class="function_list">
 	<tr>
@@ -230,6 +238,14 @@ <h2><a href="#Search_Methods">Search Methods </a></h2>
 	<td class="summary">Parses search from URL and returns an instance of Ada URL Search.</td>
 	</tr>
 	<tr>
+	<td class="name" nowrap><a href="#url:search_decode">url:search_decode ()</a></td>
+	<td class="summary">Decodes search parameters from URL and returns a Lua table of them.</td>
+	</tr>
+	<tr>
+	<td class="name" nowrap><a href="#url:search_decode_all">url:search_decode_all (url)</a></td>
+	<td class="summary">Decodes all search parameters from URL and returns a Lua table of them.</td>
+	</tr>
+	<tr>
 	<td class="name" nowrap><a href="#url:search_has">url:search_has (key)</a></td>
 	<td class="summary">Checks whether the url has a search with a key.</td>
 	</tr>
@@ -327,6 +343,55 @@ <h2><a href="#Properties">Properties </a></h2>
 <br/>
 
 
+    <h2 class="section-header "><a name="Decode_Methods"></a>Decode Methods </h2>
+
+    <dl class="function">
+    <dt>
+    <a name = "url:decode"></a>
+    <strong>url:decode ()</strong>
+    </dt>
+    <dd>
+    Decodes URL and return its components in Lua table.</p>
+
+<p> Given a following URL:
+    https://user:pass@example.com:1234/foo/bar?baz#quux</p>
+
+<p> This function will return following table:
+    {
+      scheme_type = 2,
+      protocol = &ldquo;https:&rdquo;,
+      username = &ldquo;user&rdquo;,
+      password = &ldquo;pass&rdquo;,
+      origin = &ldquo;https://example.com:1234&rdquo;,
+      host_type = 0,
+      host = &ldquo;example.com:1234&rdquo;,
+      hostname = &ldquo;example.com&rdquo;,
+      port = 1234,
+      pathname = &ldquo;/foo/bar&rdquo;,
+      search = &ldquo;?baz&rdquo;,
+      hash = &ldquo;#quux&rdquo;,
+    }
+
+
+
+    <h3>Returns:</h3>
+    <ol>
+
+           <span class="types"><a class="type" href="https://www.lua.org/manual/5.1/manual.html#5.5">table</a></span>
+        table of URL components
+    </ol>
+
+
+
+    <h3>Usage:</h3>
+    <ul>
+        <pre class="example"><span class="keyword">local</span> url = <span class="global">require</span>(<span class="string">"resty.ada"</span>).<span class="function-name">parse</span>(
+  <span class="string">"https://user:pass@host:1234/path?search#hash"</span>)
+<span class="keyword">local</span> res = url:<span class="function-name">decode</span>()</pre>
+    </ul>
+
+</dd>
+</dl>
     <h2 class="section-header "><a name="Has_Methods"></a>Has Methods </h2>
 
     <dl class="function">
@@ -1235,6 +1300,8 @@ <h3>Usage:</h3>
     <dd>
     Sets port to the URL.</p>
 
+<p> Note: inf, -inf and NaN are considered invalid and they raise an error.</p>
+
 <p> See: <a href="https://url.spec.whatwg.org/#dom-url-port">https://url.spec.whatwg.org/#dom-url-port</a>
 
 
@@ -1253,7 +1320,7 @@ <h3>Returns:</h3>
         self (except on errors <code>nil</code>)</li>
         <li>
            <span class="types"><span class="type">nil</span> or <a class="type" href="https://www.lua.org/manual/5.1/manual.html#5.4">string</a></span>
-        error message</li>
+        error message (e.g. when port is out of acceptable range)</li>
     </ol>
 
     <h3>Raises:</h3>
@@ -1491,6 +1558,78 @@ <h3>Usage:</h3>
 <span class="keyword">local</span> search = url:<span class="function-name">search_parse</span>()</pre>
     </ul>
 
+</dd>
+    <dt>
+    <a name = "url:search_decode"></a>
+    <strong>url:search_decode ()</strong>
+    </dt>
+    <dd>
+    Decodes search parameters from URL and returns a Lua table of them.</p>
+
+<p> If same parameter appears multiple times, only the value of the
+ first is returned.</p>
+
+<p> An example return value:
+    {
+      key1 = &ldquo;value&rdquo;,
+      key2 = &ldquo;value2&rdquo;,
+    }
+
+
+
+    <h3>Returns:</h3>
+    <ol>
+
+           <span class="types"><a class="type" href="https://www.lua.org/manual/5.1/manual.html#5.5">table</a></span>
+        a table of all search parameters (a string:string map).
+    </ol>
+
+
+
+    <h3>Usage:</h3>
+    <ul>
+        <pre class="example"><span class="keyword">local</span> url = <span class="global">require</span>(<span class="string">"resty.ada"</span>).<span class="function-name">parse</span>(<span class="string">"http://host/?a=b&amp;c=d&amp;e=f&amp;a=g"</span>)
+<span class="keyword">local</span> result = url:<span class="function-name">search_decode</span>()</pre>
+    </ul>
+
+</dd>
+    <dt>
+    <a name = "url:search_decode_all"></a>
+    <strong>url:search_decode_all (url)</strong>
+    </dt>
+    <dd>
+    Decodes all search parameters from URL and returns a Lua table of them.</p>
+
+<p> An example return value:
+    {
+      key1 = { &ldquo;first&rdquo;, &ldquo;second&rdquo;, },
+      key2 = { &ldquo;value&rdquo; },
+    }
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">url</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.1/manual.html#5.4">string</a></span>
+         url (with search) to parse
+        </li>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+           <span class="types"><a class="type" href="https://www.lua.org/manual/5.1/manual.html#5.5">table</a></span>
+        a table of all search parameters (a string:table [array] map).
+    </ol>
+
+
+
+    <h3>Usage:</h3>
+    <ul>
+        <pre class="example"><span class="keyword">local</span> url = <span class="global">require</span>(<span class="string">"resty.ada"</span>).<span class="function-name">parse</span>(<span class="string">"http://host/?a=b&amp;a=c&amp;d=e"</span>)
+<span class="keyword">local</span> result = url:<span class="function-name">search_decode_all</span>()</pre>
+    </ul>
+
 </dd>
     <dt>
     <a name = "url:search_has"></a>
@@ -2124,7 +2263,7 @@ <h2 class="section-header "><a name="Properties"></a>Properties </h2>
 </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 2024-08-20 21:17:51 </i>
+<i style="float:right;">Last updated 2024-09-03 15:49:45 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/index.html b/docs/index.html
index 508a66a..e46914d 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -77,7 +77,7 @@ <h2>Classes</h2>
 </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 2024-08-20 21:17:51 </i>
+<i style="float:right;">Last updated 2024-09-03 15:49:45 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/modules/resty.ada.html b/docs/modules/resty.ada.html
index 82f24ad..f67a09e 100644
--- a/docs/modules/resty.ada.html
+++ b/docs/modules/resty.ada.html
@@ -37,6 +37,7 @@ <h2>Contents</h2>
 <li><a href="#Constructors">Constructors </a></li>
 <li><a href="#Convert_Functions">Convert Functions </a></li>
 <li><a href="#Validate_Functions">Validate Functions </a></li>
+<li><a href="#Decode_Functions">Decode Functions </a></li>
 <li><a href="#Has_Functions">Has Functions </a></li>
 <li><a href="#Get_Functions">Get Functions </a></li>
 <li><a href="#Set_Functions">Set Functions </a></li>
@@ -100,6 +101,13 @@ <h2><a href="#Validate_Functions">Validate Functions </a></h2>
 	<td class="summary">Checks whether the URL can be parsed with a base URL.</td>
 	</tr>
 </table>
+<h2><a href="#Decode_Functions">Decode Functions </a></h2>
+<table class="function_list">
+	<tr>
+	<td class="name" nowrap><a href="#decode">decode ()</a></td>
+	<td class="summary">Decodes URL and return its components in Lua table.</td>
+	</tr>
+</table>
 <h2><a href="#Has_Functions">Has Functions </a></h2>
 <table class="function_list">
 	<tr>
@@ -260,6 +268,18 @@ <h2><a href="#Search_Functions">Search Functions </a></h2>
 	<td class="summary">Parses search from URL and returns an instance of Ada URL Search.</td>
 	</tr>
 	<tr>
+	<td class="name" nowrap><a href="#search_encode">search_encode (url)</a></td>
+	<td class="summary">Encodes search parameters from URL and returns an query string.</td>
+	</tr>
+	<tr>
+	<td class="name" nowrap><a href="#search_decode">search_decode (url)</a></td>
+	<td class="summary">Decodes search parameters from URL and returns a Lua table of them.</td>
+	</tr>
+	<tr>
+	<td class="name" nowrap><a href="#search_decode_all">search_decode_all (url)</a></td>
+	<td class="summary">Decodes all search parameters and returns a Lua table of them.</td>
+	</tr>
+	<tr>
 	<td class="name" nowrap><a href="#search_has">search_has (url, key)</a></td>
 	<td class="summary">Checks whether the url has a search with a key.</td>
 	</tr>
@@ -642,6 +662,63 @@ <h3>Usage:</h3>
                                    <span class="string">"https://user:pass@host:1234"</span>)</pre>
     </ul>
 
+</dd>
+</dl>
+    <h2 class="section-header "><a name="Decode_Functions"></a>Decode Functions </h2>
+
+    <dl class="function">
+    <dt>
+    <a name = "decode"></a>
+    <strong>decode ()</strong>
+    </dt>
+    <dd>
+    Decodes URL and return its components in Lua table.</p>
+
+<p> Given a following URL:
+    https://user:pass@example.com:1234/foo/bar?baz#quux</p>
+
+<p> This function will return the following table:</p>
+
+<pre><code>{
+  origin = "https://example.com:1234",
+  scheme_type = 2,
+  protocol = "https:",
+  username = "user",
+  password = "pass",
+  host_type = 0,
+  host = "example.com:1234",
+  hostname = "example.com",
+  port = 1234,
+  pathname = "/foo/bar",
+  search = "?baz",
+  hash = "#quux",
+}
+</code></pre>
+
+<p> The missing ones will be returned as empty string <code>&quot;&quot;</code> (rather than <code>nil</code>).
+
+
+
+    <h3>Returns:</h3>
+    <ol>
+        <li>
+           <span class="types"><a class="type" href="https://www.lua.org/manual/5.1/manual.html#5.5">table</a> or <span class="type">nil</span></span>
+        table of URL components (except on errors <code>nil</code>)</li>
+        <li>
+           <span class="types"><span class="type">nil</span> or <a class="type" href="https://www.lua.org/manual/5.1/manual.html#5.4">string</a></span>
+        error message</li>
+    </ol>
+
+    <h3>Raises:</h3>
+    error when url is not a string
+
+
+    <h3>Usage:</h3>
+    <ul>
+        <pre class="example"><span class="keyword">local</span> ada = <span class="global">require</span>(<span class="string">"resty.ada"</span>)
+<span class="keyword">local</span> res = ada.<span class="function-name">decode</span>(<span class="string">"https://user:pass@host:1234/path?search#hash"</span>)</pre>
+    </ul>
+
 </dd>
 </dl>
     <h2 class="section-header "><a name="Has_Functions"></a>Has Functions </h2>
@@ -2306,7 +2383,138 @@ <h3>Raises:</h3>
 
     <h3>Usage:</h3>
     <ul>
-        <pre class="example"><span class="keyword">local</span> search = <span class="global">require</span>(<span class="string">"resty.ada.search"</span>).<span class="function-name">parse</span>(<span class="string">"a=b&amp;c=d&amp;e=f"</span>)</pre>
+        <pre class="example"><span class="keyword">local</span> ada = <span class="global">require</span>(<span class="string">"resty.ada"</span>)
+<span class="keyword">local</span> res = ada.<span class="function-name">search_parse</span>(<span class="string">"http://host/?a=b&amp;c=d&amp;e=f&amp;a=g"</span>)</pre>
+    </ul>
+
+</dd>
+    <dt>
+    <a name = "search_encode"></a>
+    <strong>search_encode (url)</strong>
+    </dt>
+    <dd>
+    Encodes search parameters from URL and returns an query string.
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">url</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.1/manual.html#5.4">string</a></span>
+         url (with search) to parse
+        </li>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+           <span class="types"><a class="type" href="https://www.lua.org/manual/5.1/manual.html#5.4">string</a></span>
+        encoded query string
+    </ol>
+
+    <h3>Raises:</h3>
+    error when url is not a string
+
+
+    <h3>Usage:</h3>
+    <ul>
+        <pre class="example"><span class="keyword">local</span> ada = <span class="global">require</span>(<span class="string">"resty.ada"</span>)
+<span class="keyword">local</span> res = ada.<span class="function-name">search_encode</span>(<span class="string">"http://host/?a=b&amp;c=d&amp;e=f&amp;a=g"</span>)</pre>
+    </ul>
+
+</dd>
+    <dt>
+    <a name = "search_decode"></a>
+    <strong>search_decode (url)</strong>
+    </dt>
+    <dd>
+    Decodes search parameters from URL and returns a Lua table of them.</p>
+
+<p> If same parameter appears multiple times, only the value of the
+ first is returned.</p>
+
+<p> Given the following URL:
+    &ldquo;http://host/?a=b&amp;c=d&amp;e=f&amp;a=g&rdquo;</p>
+
+<p> The following table is returned:
+    {
+      a = &ldquo;b&rdquo;,
+      c = &ldquo;d&rdquo;,
+      e = &ldquo;f&rdquo;,
+    }
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">url</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.1/manual.html#5.4">string</a></span>
+         url (with search) to parse
+        </li>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+        <li>
+           <span class="types"><a class="type" href="https://www.lua.org/manual/5.1/manual.html#5.5">table</a> or <span class="type">nil</span></span>
+        a table of all search parameters (a string:string map).</li>
+        <li>
+           <span class="types"><span class="type">nil</span> or <a class="type" href="https://www.lua.org/manual/5.1/manual.html#5.4">string</a></span>
+        error message</li>
+    </ol>
+
+    <h3>Raises:</h3>
+    error when url is not a string
+
+
+    <h3>Usage:</h3>
+    <ul>
+        <pre class="example"><span class="keyword">local</span> ada = <span class="global">require</span>(<span class="string">"resty.ada"</span>)
+<span class="keyword">local</span> res = ada.<span class="function-name">search_decode</span>(<span class="string">"http://host/?a=b&amp;c=d&amp;e=f&amp;a=g"</span>)</pre>
+    </ul>
+
+</dd>
+    <dt>
+    <a name = "search_decode_all"></a>
+    <strong>search_decode_all (url)</strong>
+    </dt>
+    <dd>
+    Decodes all search parameters and returns a Lua table of them.</p>
+
+<p> Given the following URL:
+    &ldquo;http://host/?a=b&amp;a=c&amp;d=e&rdquo;"</p>
+
+<p> The following table is returned:
+    {
+      a = { &ldquo;b&rdquo;, &ldquo;c&rdquo; },
+      d = { &ldquo;e&rdquo; },
+    }
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">url</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.1/manual.html#5.4">string</a></span>
+         url (with search) to parse
+        </li>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+        <li>
+           <span class="types"><a class="type" href="https://www.lua.org/manual/5.1/manual.html#5.5">table</a> or <span class="type">nil</span></span>
+        a table of all search parameters (a string:table [array] map).</li>
+        <li>
+           <span class="types"><span class="type">nil</span> or <a class="type" href="https://www.lua.org/manual/5.1/manual.html#5.4">string</a></span>
+        error message</li>
+    </ol>
+
+    <h3>Raises:</h3>
+    error when url is not a string
+
+
+    <h3>Usage:</h3>
+    <ul>
+        <pre class="example"><span class="keyword">local</span> ada = <span class="global">require</span>(<span class="string">"resty.ada"</span>)
+<span class="keyword">local</span> res = ada.<span class="function-name">search_decode_all</span>(<span class="string">"http://host/?a=b&amp;a=c&amp;d=e"</span>)</pre>
     </ul>
 
 </dd>
@@ -2976,7 +3184,7 @@ <h3>Usage:</h3>
 </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 2024-08-20 21:17:51 </i>
+<i style="float:right;">Last updated 2024-09-03 15:49:45 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/modules/resty.ada.search.html b/docs/modules/resty.ada.search.html
index d863ed1..567bd1f 100644
--- a/docs/modules/resty.ada.search.html
+++ b/docs/modules/resty.ada.search.html
@@ -38,6 +38,7 @@ <h2>Contents</h2>
 <li><a href="#Has_Functions">Has Functions </a></li>
 <li><a href="#Get_Functions">Get Functions </a></li>
 <li><a href="#Set_Functions">Set Functions </a></li>
+<li><a href="#Encode_and_Decode_Functions">Encode and Decode Functions </a></li>
 <li><a href="#Remove_Functions">Remove Functions </a></li>
 <li><a href="#Iterate_Functions">Iterate Functions </a></li>
 <li><a href="#Other_Functions">Other Functions </a></li>
@@ -104,6 +105,21 @@ <h2><a href="#Set_Functions">Set Functions </a></h2>
 	<td class="summary">Append value to the the search parameter.</td>
 	</tr>
 </table>
+<h2><a href="#Encode_and_Decode_Functions">Encode and Decode Functions </a></h2>
+<table class="function_list">
+	<tr>
+	<td class="name" nowrap><a href="#encode">encode (params)</a></td>
+	<td class="summary">Encodes search parameters and returns an query string.</td>
+	</tr>
+	<tr>
+	<td class="name" nowrap><a href="#decode">decode (search)</a></td>
+	<td class="summary">Decodes search parameters and returns a Lua table of them.</td>
+	</tr>
+	<tr>
+	<td class="name" nowrap><a href="#decode_all">decode_all (search)</a></td>
+	<td class="summary">Decodes all search parameters and returns a Lua table of them.</td>
+	</tr>
+</table>
 <h2><a href="#Remove_Functions">Remove Functions </a></h2>
 <table class="function_list">
 	<tr>
@@ -455,6 +471,150 @@ <h3>Usage:</h3>
 <span class="keyword">local</span> result = search.<span class="function-name">append</span>(<span class="string">"a=b&amp;c=d&amp;e=f"</span>, <span class="string">"a"</span>, <span class="string">"g"</span>)</pre>
     </ul>
 
+</dd>
+</dl>
+    <h2 class="section-header "><a name="Encode_and_Decode_Functions"></a>Encode and Decode Functions </h2>
+
+    <dl class="function">
+    <dt>
+    <a name = "encode"></a>
+    <strong>encode (params)</strong>
+    </dt>
+    <dd>
+    Encodes search parameters and returns an query string.</p>
+
+<ul>
+<li>only <a href="https://www.lua.org/manual/5.1/manual.html#5.4">string</a> keys are allowed.</li>
+<li>only <a href="https://www.lua.org/manual/5.1/manual.html#5.4">string</a>, <code>boolean</code> and <code>number</code> values are allowed or an array of them</li>
+<li><code>false</code> value is treated as missing (same as <code>nil</code>)</li>
+<li><code>true</code> returns <code>&quot;&quot;</code> (empty string)</li>
+<li>negative and positive <code>inf</code> and <code>NaN</code> are not allowed as numbers in values</li>
+</ul>
+
+
+<p> When passing a table the keys will be sorted and with string the given order
+ is preserved.
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">params</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.1/manual.html#5.5">table</a> or <a class="type" href="https://www.lua.org/manual/5.1/manual.html#5.4">string</a></span>
+         search parameters to encode (either a <a href="https://www.lua.org/manual/5.1/manual.html#5.5">table</a> or <a href="https://www.lua.org/manual/5.1/manual.html#5.4">string</a>)
+        </li>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+           <span class="types"><a class="type" href="https://www.lua.org/manual/5.1/manual.html#5.4">string</a></span>
+        encoded query string
+    </ol>
+
+    <h3>Raises:</h3>
+    error when search or key is not a table or string, or when the rules above are not followed
+
+
+    <h3>Usage:</h3>
+    <ul>
+        <pre class="example"><span class="keyword">local</span> search = <span class="global">require</span>(<span class="string">"resty.ada.search"</span>)
+<span class="keyword">local</span> result = search.<span class="function-name">encode</span>({
+  g = <span class="string">"h"</span>,
+  a = { <span class="string">"f"</span>, <span class="string">"b"</span>, },
+  c = <span class="string">"d"</span>,
+})</pre>
+    </ul>
+
+</dd>
+    <dt>
+    <a name = "decode"></a>
+    <strong>decode (search)</strong>
+    </dt>
+    <dd>
+    Decodes search parameters and returns a Lua table of them.</p>
+
+<p> If same parameter appears multiple times, only the value of the
+ first is returned.</p>
+
+<p> Given the following query string:
+    &ldquo;a=b&amp;c=d&amp;e=f&amp;a=g&rdquo;</p>
+
+<p> The following table is returned:
+    {
+      a = &ldquo;b&rdquo;,
+      c = &ldquo;d&rdquo;,
+      e = &ldquo;f&rdquo;,
+    }
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">search</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.1/manual.html#5.4">string</a></span>
+         search to parse
+        </li>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+           <span class="types"><a class="type" href="https://www.lua.org/manual/5.1/manual.html#5.5">table</a></span>
+        a table of all search parameters (a string:string map).
+    </ol>
+
+    <h3>Raises:</h3>
+    error when search or key is not a string
+
+
+    <h3>Usage:</h3>
+    <ul>
+        <pre class="example"><span class="keyword">local</span> search = <span class="global">require</span>(<span class="string">"resty.ada.search"</span>)
+<span class="keyword">local</span> result = search.<span class="function-name">decode</span>(<span class="string">"a=b&amp;c=d&amp;e=f&amp;a=g"</span>)</pre>
+    </ul>
+
+</dd>
+    <dt>
+    <a name = "decode_all"></a>
+    <strong>decode_all (search)</strong>
+    </dt>
+    <dd>
+    Decodes all search parameters and returns a Lua table of them.</p>
+
+<p> Given the following query string:
+    &ldquo;a=b&amp;a=c&amp;d=e&rdquo;"</p>
+
+<p> The following table is returned:
+    {
+      a = { &ldquo;b&rdquo;, &ldquo;c&rdquo; },
+      d = { &ldquo;e&rdquo; },
+    }
+
+
+    <h3>Parameters:</h3>
+    <ul>
+        <li><span class="parameter">search</span>
+            <span class="types"><a class="type" href="https://www.lua.org/manual/5.1/manual.html#5.4">string</a></span>
+         search to parse
+        </li>
+    </ul>
+
+    <h3>Returns:</h3>
+    <ol>
+
+           <span class="types"><a class="type" href="https://www.lua.org/manual/5.1/manual.html#5.5">table</a></span>
+        a table of all search parameters (a string:table [array] map).
+    </ol>
+
+    <h3>Raises:</h3>
+    error when search or key is not a string
+
+
+    <h3>Usage:</h3>
+    <ul>
+        <pre class="example"><span class="keyword">local</span> search = <span class="global">require</span>(<span class="string">"resty.ada.search"</span>)
+<span class="keyword">local</span> result = search.<span class="function-name">decode_all</span>(<span class="string">"a=b&amp;a=c&amp;d=e"</span>)</pre>
+    </ul>
+
 </dd>
 </dl>
     <h2 class="section-header "><a name="Remove_Functions"></a>Remove Functions </h2>
@@ -823,7 +983,7 @@ <h3>Usage:</h3>
 </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 2024-08-20 21:17:51 </i>
+<i style="float:right;">Last updated 2024-09-03 15:49:45 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/lib/resty/ada.lua b/lib/resty/ada.lua
index 14ee6d7..fea7b44 100644
--- a/lib/resty/ada.lua
+++ b/lib/resty/ada.lua
@@ -26,7 +26,7 @@ local setmetatable = setmetatable
 
 
 local _OMITTED = 0xffffffff
-local _VERSION = "1.0.1"
+local _VERSION = "1.1.0"
 
 
 local function parse_component(c, raw)
diff --git a/lua-resty-ada-1.0.1-1.rockspec b/lua-resty-ada-1.1.0-1.rockspec
similarity index 95%
rename from lua-resty-ada-1.0.1-1.rockspec
rename to lua-resty-ada-1.1.0-1.rockspec
index 9f9cc5f..6b67c93 100644
--- a/lua-resty-ada-1.0.1-1.rockspec
+++ b/lua-resty-ada-1.1.0-1.rockspec
@@ -1,8 +1,8 @@
 package = "lua-resty-ada"
-version = "1.0.1-1"
+version = "1.1.0-1"
 source = {
   url = "git+https://github.com/bungle/lua-resty-ada.git",
-  tag = "v1.0.1",
+  tag = "v1.1.0",
 }
 description = {
   summary = "LuaJIT FFI bindings to Ada — WHATWG-compliant and fast URL parser",