fix!: query param serialization/parsing (#381)

respect the `style` and `explode` modifiers on `in: query` parameters.

this is required to generate working clients for
https://github.com/typesense/typesense-api-spec for example, as it
defines the query parameters as a single object that should be
"exploded" (eg: flattened) to multiple parameters.

removes the `qs` dependency in favor of our own parsing / serialization
based on the `style` + `explode` modifiers.

in addition to the e2e tests in this repository, I've tested the
generated clients e2e against a typesense server, which previously
didn't work.

Author: mnahkies

e2e/openapi.yaml

@@ -54,6 +54,148 @@ paths:
         200:
           $ref: '#/components/responses/GetHeaders'
 
+  /params/simple-query:
+    get:
+      tags:
+        - query-parameters
+      parameters:
+        - name: orderBy
+          in: query
+          required: true
+          schema:
+            type: string
+            enum: [ asc, desc ]
+        - name: limit
+          in: query
+          required: true
+          schema:
+            type: number
+      responses:
+        200:
+          description: success
+          content:
+            application/json:
+              schema:
+                type: object
+                required:
+                  - orderBy
+                  - limit
+                properties:
+                  orderBy:
+                    type: string
+                  limit:
+                    type: number
+  /params/default-object-query:
+    get:
+      tags:
+        - query-parameters
+      parameters:
+        - name: filter
+          in: query
+          required: true
+          schema:
+            type: object
+            required:
+              - name
+              - age
+            properties:
+              name:
+                type: string
+              age:
+                type: number
+      responses:
+        200:
+          description: success
+          content:
+            application/json:
+              schema:
+                type: object
+                required:
+                  - filter
+                properties:
+                  filter:
+                    type: object
+                    required:
+                      - name
+                      - age
+                    properties:
+                      name:
+                        type: string
+                      age:
+                        type: number
+  /params/unexploded-object-query:
+    get:
+      tags:
+        - query-parameters
+      parameters:
+        - name: filter
+          in: query
+          required: true
+          explode: false
+          schema:
+            type: object
+            required:
+              - name
+              - age
+            properties:
+              name:
+                type: string
+              age:
+                type: number
+      responses:
+        200:
+          description: success
+          content:
+            application/json:
+              schema:
+                type: object
+                required:
+                  - filter
+                properties:
+                  filter:
+                    type: object
+                    required:
+                      - name
+                      - age
+                    properties:
+                      name:
+                        type: string
+                      age:
+                        type: number
+  /params/mixed-query:
+    get:
+      tags:
+        - query-parameters
+      parameters:
+        - name: limit
+          in: query
+          required: true
+          schema:
+            type: number
+        - name: statuses
+          in: query
+          required: true
+          schema:
+            type: array
+            items:
+              type: string
+              enum:
+                - open
+                - closed
+      responses:
+        200:
+          description: success
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  limit:
+                    type: number
+                  statuses:
+                    type: array
+                    items:
+                      type: string
   /validation/numbers/random-number:
     get:
       tags:
@@ -127,6 +269,7 @@ paths:
                     type: string
         204:
           description: ok
+
   /responses/500:
     get:
       tags:

e2e/src/express.entrypoint.ts

@@ -2,6 +2,7 @@ import {type NextFunction, type Request, type Response, Router} from "express"
 import {bootstrap} from "./generated/server/express/index.ts"
 import {createEscapeHatchesRouter} from "./routes/express/escape-hatches.ts"
 import {createMediaTypesRouter} from "./routes/express/media-types.ts"
+import {createQueryParametersRouter} from "./routes/express/query-parameters.ts"
 import {createRequestHeadersRouter} from "./routes/express/request-headers.ts"
 import {createValidationRouter} from "./routes/express/validation.ts"
 import {createErrorResponse} from "./shared.ts"
@@ -13,11 +14,13 @@ function createRouter() {
   const validationRouter = createValidationRouter()
   const escapeHatchesRouter = createEscapeHatchesRouter()
   const mediaTypesRouter = createMediaTypesRouter()
+  const queryParametersRouter = createQueryParametersRouter()
 
   router.use(requestHeadersRouter)
   router.use(validationRouter)
   router.use(escapeHatchesRouter)
   router.use(mediaTypesRouter)
+  router.use(queryParametersRouter)
 
   return router
 }