| Title: | HTTP Cookies Parser Middleware |
| Version: | 1.0.0 |
| Description: | A cookie is a piece of data sent from a web server to a web client which helps in overcoming the statelessness constraint of the HTTP protocol. This package provides the tools to work with them in the form of a cookie parser middleware function, meant to be attached to a bigger R web application, and utilities to write, sign and unsign a cookie. For more details see the Mozilla Developer Network (MDN) web documentation in https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/Cookies. |
| License: | MIT + file LICENSE |
| Encoding: | UTF-8 |
| RoxygenNote: | 7.3.3 |
| Imports: | secretbase, utils |
| Suggests: | curl, httpuv, later, R6, routing, testthat (≥ 3.0.0), yyjsonr |
| Config/testthat/edition: | 3 |
| NeedsCompilation: | no |
| Packaged: | 2026-06-06 04:44:40 UTC; julio |
| Author: | Julio Collazos 
[aut, cre],
cookie contributors [ctb, cph] (cookie contributors; authors listed in
<https://github.com/jshttp/cookie/graphs/contributors>),
cookie-parser contributors [ctb, cph] (cookie-parser contributors;
authors listed in
<https://github.com/expressjs/cookie-parser/graphs/contributors>),
cookie-signature contributors [ctb, cph] (cookie-signature
contributors; authors listed in
<https://github.com/tj/node-cookie-signature/graphs/contributors>),
httpuv authors [ctb, cph] (Development of the http_date_string
function) |
| Maintainer: | Julio Collazos <amarullazo626@gmail.com> |
| Repository: | CRAN |
| Date/Publication: | 2026-06-12 10:10:09 UTC |
Cookie Parser Middleware
Description
Creates a middleware function that parses the Cookie HTTP header and
populates req$cookies. When a secret is provided, signed cookies are
verified and exposed on req$signedCookies.
Usage
cookieParser(secret = NULL, options = NULL)
Arguments
secret |
A character vector or list of strings used to sign and verify cookies. Optional. |
options |
A function used to decode cookie values. Defaults to
|
Value
A middleware function that sets req$cookies,
req$signedCookies, and req$secret, then calls forward().
Serialise a Set-Cookie Header
Description
Serialises a cookie name-value pair into a Set-Cookie header string.
Usage
serialise(name, val = NULL, ...)
Arguments
name |
A string with the cookie name, or a list with |
val |
A string. The cookie value. |
... |
Additional cookie attributes:
|
Value
A Set-Cookie header string.
Examples
serialise("session", "abc123")
serialise("id", "42", httpOnly = TRUE, secure = TRUE, sameSite = "lax")
Sign a Cookie Value
Description
Sign the given val with secret.
Usage
sign(val, secret)
Arguments
val |
A string. The cookie value to sign. |
secret |
The secret key used to generate the signature. |
Value
A string of the form "<val>.<signature>".
Examples
sign("hello", "tobiiscool")
Unsign a Cookie Value
Description
Verifies the signature of a signed cookie value and returns the original
value if valid, or FALSE if the signature does not match.
Usage
unsign(input, secret)
Arguments
input |
A string. A signed cookie value produced by |
secret |
The secret key to verify against. |
Value
The original unsigned value if verification succeeds, FALSE
otherwise.
Examples
input <- sign("hello", "tobiiscool")
unsign(input, "tobiiscool")
unsign(input, "luna")