spooder 6.1.2 → 6.1.3

package/README.md

@@ -104,6 +104,7 @@ The `CLI` component of `spooder` is a global command-line tool for running serve
 	- [API > HTTP > Webhooks](#api-http-webhooks)
 	- [API > HTTP > Websocket Server](#api-http-websockets)
 	- [API > HTTP > Bootstrap](#api-http-bootstrap)
+	- [API > HTTP > Cookies](#api-http-cookies)
 - [API > Error Handling](#api-error-handling)
 - [API > Workers](#api-workers)
 - [API > Caching](#api-caching)
@@ -1416,6 +1417,35 @@ server.websocket('/path/to/websocket', {
 > [!IMPORTANT]
 > While it is possible to register multiple routes for websockets, the only handler which is unique per route is `accept()`. The last handlers provided to any route (with the exception of `accept()`) will apply to ALL websocket routes. This is a limitation in Bun.
 
+<a id="api-http-cookies"></a>
+## API > HTTP > Cookies
+
+### 🔧 `cookies_get(req: Request): Bun.CookieMap`
+
+When called on a request, the `cookies_get` function will return a `Bun.CookieMap` contains all of the cookies parsed from the `Cookie` header on the request.
+
+```ts
+server.route('/', (req, url) => {
+	const cookies = cookies_get(req);
+	return `Hello ${cookies.get('person') ?? 'unknown'}`;
+});
+```
+
+The return `Bun.CookieMap` is an iterable map with a custom API for reading/setting cookies. The full API [can be seen here](https://bun.com/docs/runtime/cookies).
+
+Any changes made to the cookie map (adding, deletion, editing, etc) will be sent as `Set-Cookie` headers on the response automatically. Unchanged cookies are not sent.
+
+```ts
+server.route('/', (req, url) => {
+	const cookies = cookies_get(req);
+	cookies.set('test', 'foobar');
+	return 'Hello, world!';
+
+	// the response automatically gets:
+	// Set-Cookie test=foobar; Path=/; SameSite=Lax
+});
+```
+
 <a id="api-http-bootstrap"></a>
 ## API > HTTP > Bootstrap
 

package/package.json

@@ -2,7 +2,7 @@
 	"name": "spooder",
 	"author": "Kruithne <kruithne@gmail.com>",
 	"type": "module",
-	"version": "6.1.2",
+	"version": "6.1.3",
 	"module": "./src/api.ts",
 	"bin": {
 		"spooder": "./src/cli.ts"

package/src/api.ts

@@ -1143,6 +1143,26 @@ export function git_get_hashes_sync(length = 7): Record<string, string> {
 }
 // endregion
 
+// region cookies
+const cookie_map = new WeakMap<Request, Bun.CookieMap>();
+
+export function cookies_get(req: Request): Bun.CookieMap {
+	const jar = new Bun.CookieMap(req.headers.get('Cookie') ?? undefined);
+	cookie_map.set(req, jar);
+	return jar;
+}
+
+function apply_cookies(req: Request, res: Response) {
+	const jar = cookie_map.get(req);
+	if (jar === undefined)
+		return;
+
+	const cookies = jar.toSetCookieHeaders();
+	for (const cookie of cookies)
+		res.headers.append('Set-Cookie', cookie);
+}
+// endregion
+
 // region serving
 export const HTTP_STATUS_TEXT: Record<number, string> = {
 	// 1xx Informational Response
@@ -1736,6 +1756,8 @@ export function http_serve(port: number, hostname?: string) {
 			
 			const response = await generate_response(req, url);
 			const request_time = Date.now() - request_start;
+
+			apply_cookies(req, response);
 			
 			const is_known_slow = slow_requests.has(req);
 			if (slow_request_callback !== null && request_time > slow_request_threshold && !is_known_slow)

package/test.ts

@@ -1,10 +0,0 @@
-import { SQL } from 'bun';
-import * as spooder from 'spooder';
-
-type TestRow = {
-	ID: number;
-	test: string;
-};
-
-const db = new SQL('mysql://test:1141483652@localhost:3306/test');
-await spooder.db_schema(db, './db/revisions');