spooder 6.1.4 → 6.1.6

package/README.md

@@ -601,6 +601,9 @@ log_list(input: any[], delimiter = ', ');
 http_serve(port: number, hostname?: string): Server;
 server.stop(immediate: boolean): Promise<void>;
 
+// cookies
+cookies_get(req: Request): Bun.CookieMap
+
 // routing
 server.route(path: string, handler: RequestHandler, method?: HTTP_METHODS);
 server.json(path: string, handler: JSONRequestHandler, method?: HTTP_METHODS);
@@ -680,6 +683,7 @@ git_get_hashes_sync(length: number): Record<string, string>;
 // database utilities
 db_set_cast<T extends string>(set: string | null): Set<T>;
 db_set_serialize<T extends string>(set: Iterable<T> | null): string;
+db_exists(db: SQL, table_name: string, value: string|number, column_name = 'id'): Promise<boolean>;
 
 // database schema
 type SchemaOptions = {
@@ -1417,35 +1421,6 @@ 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
 
@@ -1778,6 +1753,35 @@ Functions in `global_subs` and route-specific `subs` are called during template
 3. Route-specific `subs` and `global_subs` are applied
 4. Hash substitutions (if enabled) are applied
 
+<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-error-handling"></a>
 ## API > Error Handling
 
@@ -2589,7 +2593,7 @@ if (set.has(Fruits.Apple)) {
 }
 ```
 
-### 🔧 ``db_set_serialize<T extends string>(set: Iterable<T> | null): string``
+### ``db_set_serialize<T extends string>(set: Iterable<T> | null): string``
 
 Takes an `Iterable<T>` and returns a database SET string. If the set is empty or `null`, it returns an empty string.
 
@@ -2613,6 +2617,18 @@ await sql`UPDATE some_table SET fruits = ${sql(db_set_serialize(fruits))} WHERE
 await sql`UPDATE some_table SET fruits = ${sql(db_set_serialize([Fruits.Apple, Fruits.Lemon]))}`;
 ```
 
+### 🔧 ``db_exists(db: SQL, table_name: string, value: string|number, column_name = 'id'): Promise<boolean>``
+
+Returns true if a database row exists in the table.
+
+```ts
+// checks if row exists with id 1 in 'table'
+const exists = await db_exists(db, 'table', 1);
+
+// checks if row exists with column 'foo' = 'bar' in 'table'
+const exists = await db_exists(db, 'table', 'bar', 'foo');
+```
+
 <a id="api-database-schema"></a>
 ## API > Database > Schema
 

package/bun.lock

@@ -1,5 +1,6 @@
 {
   "lockfileVersion": 1,
+  "configVersion": 1,
   "workspaces": {
     "": {
       "name": "spooder",
@@ -9,15 +10,11 @@
     },
   },
   "packages": {
-    "@types/bun": ["@types/bun@1.3.1", "", { "dependencies": { "bun-types": "1.3.1" } }, "sha512-4jNMk2/K9YJtfqwoAa28c8wK+T7nvJFOjxI4h/7sORWcypRNxBpr+TPNaCfVWq70tLCJsqoFwcf0oI0JU/fvMQ=="],
+    "@types/bun": ["@types/bun@1.3.3", "", { "dependencies": { "bun-types": "1.3.3" } }, "sha512-ogrKbJ2X5N0kWLLFKeytG0eHDleBYtngtlbu9cyBKFtNL3cnpDZkNdQj8flVf6WTZUX5ulI9AY1oa7ljhSrp+g=="],
 
-    "@types/node": ["@types/node@24.9.2", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-uWN8YqxXxqFMX2RqGOrumsKeti4LlmIMIyV0lgut4jx7KQBcBiW6vkDtIBvHnHIquwNfJhk8v2OtmO8zXWHfPA=="],
+    "@types/node": ["@types/node@24.10.1", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-GNWcUTRBgIRJD5zj+Tq0fKOJ5XZajIiBroOF0yvj2bSU1WvNdYS/dn9UxwsujGW4JX06dnHyjV2y9rRaybH0iQ=="],
 
-    "@types/react": ["@types/react@19.2.2", "", { "dependencies": { "csstype": "^3.0.2" } }, "sha512-6mDvHUFSjyT2B2yeNx2nUgMxh9LtOWvkhIU3uePn2I2oyNymUAX1NIsdgviM4CH+JSrp2D2hsMvJOkxY+0wNRA=="],
-
-    "bun-types": ["bun-types@1.3.1", "", { "dependencies": { "@types/node": "*" }, "peerDependencies": { "@types/react": "^19" } }, "sha512-NMrcy7smratanWJ2mMXdpatalovtxVggkj11bScuWuiOoXTiKIu2eVS1/7qbyI/4yHedtsn175n4Sm4JcdHLXw=="],
-
-    "csstype": ["csstype@3.1.3", "", {}, "sha512-M1uQkMl8rQK/szD0LNhtqxIPLpimGm8sOBwU7lLnCpSbTyY3yeU1Vc7l4KT5zT4s/yOxHH5O7tIuuLOCnLADRw=="],
+    "bun-types": ["bun-types@1.3.3", "", { "dependencies": { "@types/node": "*" } }, "sha512-z3Xwlg7j2l9JY27x5Qn3Wlyos8YAp0kKRlrePAOjgjMGS5IG6E7Jnlx736vH9UVI4wUICwwhC9anYL++XeOgTQ=="],
 
     "undici-types": ["undici-types@7.16.0", "", {}, "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw=="],
   }

package/package.json

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

package/src/api.ts

@@ -1841,24 +1841,37 @@ export function http_serve(port: number, hostname?: string) {
 		/** Register a JSON endpoint with automatic content validation. */
 		json: (path: string, handler: JSONRequestHandler, method: HTTP_METHODS = 'POST'): void => {
 			const json_wrapper: RequestHandler = async (req: Request, url: URL) => {
+				// handle CORS preflight
+				if (req.method === 'OPTIONS') {
+					return new Response(null, {
+						status: 204,
+						headers: {
+							'Access-Control-Allow-Origin': '*',
+							'Access-Control-Allow-Methods': `${Array.isArray(method) ? method.join(', ') : method}, OPTIONS`,
+							'Access-Control-Allow-Headers': 'Content-Type, User-Agent'
+						}
+					});
+				}
+
 				try {
 					if (req.headers.get('Content-Type') !== 'application/json')
 						return 400; // Bad Request
-					
+
 					const json = await req.json();
 					if (json === null || typeof json !== 'object' || Array.isArray(json))
 						return 400; // Bad Request
-					
+
 					return handler(req, url, json as JsonObject);
 				} catch (e) {
 					return 400; // Bad Request
 				}
 			};
-			
+
 			if (path.length > 1 && path.endsWith('/'))
 				path = path.slice(0, -1);
-			
-			routes.push([path.split('/'), json_wrapper, method]);
+
+			const methods: HTTP_METHODS = Array.isArray(method) ? [...method, 'OPTIONS'] : [method, 'OPTIONS'];
+			routes.push([path.split('/'), json_wrapper, methods]);
 		},
 		
 		/** Unregister a specific route */
@@ -2182,6 +2195,11 @@ export function db_set_serialize<T extends string>(set: Iterable<T> | null): str
 	return set ? Array.from(set).join(',') : '';
 }
 
+export async function db_exists(db: SQL, table_name: string, value: string|number, column_name = 'id'): Promise<boolean> {
+	const rows = await db`SELECT 1 FROM ${db(table_name)} WHERE ${db(column_name)} = ${value} LIMIT 1`;
+	return rows.length > 0;
+}
+
 export async function db_get_schema_revision(db: SQL): Promise<number|null> {
 	try {
 		const [result] = await db`SELECT MAX(revision_number) as latest_revision FROM db_schema`;