@thi.ng/server 0.12.21 → 0.12.22

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.22",
 	"description": "Minimal HTTP server with declarative routing, static file serving and freely extensible via pre/post interceptors",
 	"type": "module",
 	"module": "./index.js",
@@ -39,25 +39,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.13",
+		"@thi.ng/arrays": "^2.14.6",
+		"@thi.ng/cache": "^2.3.62",
+		"@thi.ng/checks": "^3.8.3",
+		"@thi.ng/errors": "^2.6.2",
+		"@thi.ng/file-io": "^2.2.23",
+		"@thi.ng/leaky-bucket": "^0.2.25",
+		"@thi.ng/logger": "^3.2.12",
+		"@thi.ng/mime": "^2.8.5",
+		"@thi.ng/paths": "^5.2.32",
+		"@thi.ng/router": "^4.1.54",
+		"@thi.ng/strings": "^3.9.34",
+		"@thi.ng/timestamp": "^1.1.32",
+		"@thi.ng/uuid": "^1.1.45"
 	},
 	"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 +167,5 @@
 		"status": "alpha",
 		"year": 2024
 	},
-	"gitHead": "deb511294f7a120091b654af0ff7e8a399a465b3\n"
+	"gitHead": "828ec2e9ffde7307231b03cff46598c0915b1857\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;
 };