spooder 6.1.4 → 6.1.5

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/package.json

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

package/src/api.ts

@@ -2182,6 +2182,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`;