@thi.ng/server 0.12.21 → 0.12.23

package/README.md

@@ -7,7 +7,7 @@
 [![Mastodon Follow](https://img.shields.io/mastodon/follow/109331703950160316?domain=https%3A%2F%2Fmastodon.thi.ng&style=social)](https://mastodon.thi.ng/@toxi)
 
 > [!NOTE]
-> This is one of 213 standalone projects, maintained as part
+> This is one of 214 standalone projects, maintained as part
 > of the [@thi.ng/umbrella](https://github.com/thi-ng/umbrella/) monorepo
 > and anti-framework.
 >

package/api.d.ts

@@ -140,7 +140,7 @@ export interface RequestCtx {
     /**
      * Parsed query string params (aka URL search params).
      */
-    query: Record<string, any>;
+    query: ParsedFormData;
     /**
      * Parsed cookies, if any.
      */
@@ -150,6 +150,9 @@ export interface RequestCtx {
      */
     session?: ServerSession;
 }
+export type ParsedFormData = {
+    [id: string]: string | string[] | ParsedFormData;
+};
 export type HandlerResult = MaybePromise<void>;
 export type PreInterceptorResult = MaybePromise<boolean>;
 export type PostInterceptorResult = MaybePromise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@thi.ng/server",
-	"version": "0.12.21",
+	"version": "0.12.23",
 	"description": "Minimal HTTP server with declarative routing, static file serving and freely extensible via pre/post interceptors",
 	"type": "module",
 	"module": "./index.js",
@@ -8,7 +8,8 @@
 	"sideEffects": false,
 	"repository": {
 		"type": "git",
-		"url": "https://github.com/thi-ng/umbrella.git"
+		"url": "git+https://github.com/thi-ng/umbrella.git",
+		"directory": "packages/server"
 	},
 	"homepage": "https://thi.ng/server",
 	"funding": [
@@ -39,25 +40,25 @@
 		"tool:tangle": "../../node_modules/.bin/tangle src/**/*.ts"
 	},
 	"dependencies": {
-		"@thi.ng/api": "^8.12.12",
-		"@thi.ng/arrays": "^2.14.5",
-		"@thi.ng/cache": "^2.3.61",
-		"@thi.ng/checks": "^3.8.2",
-		"@thi.ng/errors": "^2.6.1",
-		"@thi.ng/file-io": "^2.2.22",
-		"@thi.ng/leaky-bucket": "^0.2.24",
-		"@thi.ng/logger": "^3.2.11",
-		"@thi.ng/mime": "^2.8.4",
-		"@thi.ng/paths": "^5.2.31",
-		"@thi.ng/router": "^4.1.53",
-		"@thi.ng/strings": "^3.9.33",
-		"@thi.ng/timestamp": "^1.1.31",
-		"@thi.ng/uuid": "^1.1.44"
+		"@thi.ng/api": "^8.12.14",
+		"@thi.ng/arrays": "^2.14.7",
+		"@thi.ng/cache": "^2.3.63",
+		"@thi.ng/checks": "^3.8.4",
+		"@thi.ng/errors": "^2.6.3",
+		"@thi.ng/file-io": "^2.2.24",
+		"@thi.ng/leaky-bucket": "^0.2.26",
+		"@thi.ng/logger": "^3.2.13",
+		"@thi.ng/mime": "^2.8.6",
+		"@thi.ng/paths": "^5.2.33",
+		"@thi.ng/router": "^4.1.55",
+		"@thi.ng/strings": "^3.9.35",
+		"@thi.ng/timestamp": "^1.1.33",
+		"@thi.ng/uuid": "^1.1.46"
 	},
 	"devDependencies": {
-		"@types/node": "^24.10.1",
-		"esbuild": "^0.27.0",
-		"typedoc": "^0.28.14",
+		"@types/node": "^24.10.9",
+		"esbuild": "^0.27.2",
+		"typedoc": "^0.28.16",
 		"typescript": "^5.9.3"
 	},
 	"keywords": [
@@ -167,5 +168,5 @@
 		"status": "alpha",
 		"year": 2024
 	},
-	"gitHead": "deb511294f7a120091b654af0ff7e8a399a465b3\n"
+	"gitHead": "4bd1b9d8ae52ba32b90a1b9a55d329c708ca7865\n"
 }

package/utils/formdata.d.ts

@@ -1,6 +1,33 @@
 import type { IncomingMessage } from "node:http";
-export declare const parseSearchParams: (params: URLSearchParams) => any;
-export declare const parseQuerystring: (url: string) => Record<string, any>;
-export declare const parseRequestFormData: (req: IncomingMessage) => Promise<Record<string, any>>;
-export declare const parseFormData: (body: string) => Record<string, any>;
+import type { ParsedFormData } from "../api.js";
+export declare const parseSearchParams: (params: URLSearchParams) => ParsedFormData;
+/**
+ * Parses given URL's query string {@link parseFormData}. Any prefix
+ * before/including the first `?` will be ignored.
+ *
+ * @param url
+ */
+export declare const parseQuerystring: (url: string) => ParsedFormData;
+export declare const parseRequestFormData: (req: IncomingMessage) => Promise<ParsedFormData>;
+/**
+ * Parses given URI-encoded string of key-value pairs into a
+ * {@link ParsedFormData} object. Throws an error if there're syntax/nesting
+ * errors.
+ *
+ * @remarks
+ * Supports the following syntax:
+ *
+ * - `key=value`
+ * - `key[]=value`: append value to `key` array
+ * - `key[a]=value`: set value `a` in object `key`
+ * - `key[a][b]=value`: set nested value in object `key`
+ * - `key[a][]=value`: append value to nested array in object `key`
+ *
+ * Ignores attempts to manipulate a JS prototype chain (via
+ * [`isProtoPath()`](https://docs.thi.ng/umbrella/checks/functions/isProtoPath.html)),
+ * i.e. `foo[__proto__][bar]=42` will be skipped.
+ *
+ * @param body
+ */
+export declare const parseFormData: (body: string) => ParsedFormData;
 //# sourceMappingURL=formdata.d.ts.map

package/utils/formdata.js

@@ -2,10 +2,10 @@ import { isArray, isProtoPath } from "@thi.ng/checks";
 import { illegalArgs } from "@thi.ng/errors";
 import { setInUnsafe, updateInUnsafe } from "@thi.ng/paths";
 const parseSearchParams = (params) => {
-  const acc = {};
+  let acc = {};
   for (const [k, v] of params) {
-    if (k.includes("[")) return parseObjectVal(acc, k, v);
-    if (!isProtoPath(k)) acc[k] = v;
+    if (k.includes("[")) acc = parseObjectVal(acc, k, v);
+    else if (!isProtoPath(k)) acc[k] = v;
   }
   return acc;
 };