feat: add worktop/cookie module (#20)

* chore: setup `cookie` entry

* feat: add `worktop/cookie` module

.gitignore

@@ -5,6 +5,7 @@ node_modules
 
 /kv
 /cache
+/cookie
 /crypto
 /base64
 /request

bin/index.js

@@ -28,6 +28,7 @@ async function bundle(input, output) {
 Promise.all([
 	bundle('src/router.ts', pkg.exports['.']),
 	bundle('src/cache.ts', pkg.exports['./cache']),
+	bundle('src/cookie.ts', pkg.exports['./cookie']),
 	bundle('src/base64.ts', pkg.exports['./base64']),
 	bundle('src/request.ts', pkg.exports['./request']),
 	bundle('src/response.ts', pkg.exports['./response']),

package.json

@@ -15,6 +15,7 @@
     ".": "./router/index.mjs",
     "./kv": "./kv/index.mjs",
     "./cache": "./cache/index.mjs",
+    "./cookie": "./cookie/index.mjs",
     "./crypto": "./crypto/index.mjs",
     "./request": "./request/index.mjs",
     "./response": "./response/index.mjs",
@@ -23,9 +24,10 @@
     "./package.json": "./package.json"
   },
   "files": [
+    "base64",
     "cache",
     "crypto",
-    "base64",
+    "cookie",
     "request",
     "response",
     "router",

readme.md

@@ -177,6 +177,13 @@ The `worktop/response` submodule contains the [`ServerResponse`](/src/response.d
 
 The `worktop/base64` submodule contains a few utilities related to the [Base 64 encoding](https://tools.ietf.org/html/rfc4648#section-4).
 
+### Module: `worktop/cookie`
+
+> [View `worktop/cookie` API documentation](/src/cookie.d.ts)
+<!-- > [View `worktop/cookie` API documentation](/docs/module.cookie.md) -->
+
+The `worktop/cookie` submodule contains `parse` and `stringify` utilities for dealing with cookie header(s).
+
 ### Module: `worktop/utils`
 
 > [View `worktop/utils` API documentation](/src/utils.d.ts)

src/cookie.d.ts

@@ -0,0 +1,12 @@
+export interface Attributes {
+	maxage?: number;
+	expires?: Date;
+	samesite?: 'Lax' | 'Strict' | 'None';
+	secure?: boolean;
+	httponly?: boolean;
+	domain?: string;
+	path?: string;
+}
+
+export function parse(cookie: string): Attributes & Record<string, string>;
+export function stringify(name: string, value: string, options: Omit<Attributes, 'expires'> & { expires?: Date | number | string }): string;