feat: spike on url encoding of json object in query param

Author: deepakrkris

examples/todo/src/__tests__/acceptance/todo.acceptance.ts

@@ -189,7 +189,7 @@ describe('TodoApplication', () => {
 
     await client
       .get('/todos')
-      .query({filter: {where: {isComplete: false}}})
+      .query({filter: encodeURIComponent(JSON.stringify({where: {isComplete: false}})) })
       .expect(200, [toJSON(todoInProgress)]);
   });
 

examples/todo/src/controllers/todo.controller.ts

@@ -84,7 +84,7 @@ export class TodoController {
     },
   })
   async findTodos(
-    @param.query.object('filter', getFilterSchemaFor(Todo))
+    @param.query.jsonObject('filter', getFilterSchemaFor(Todo))
     filter?: Filter<Todo>,
   ): Promise<Todo[]> {
     return this.todoRepo.find(filter);

packages/openapi-v3/src/decorators/parameter.decorator.ts

@@ -218,8 +218,47 @@ export namespace param {
         ...spec,
       });
     },
+
+    /**
+     * Define a parameter accepting a url encoded string of a JSON object,
+     *
+     * parameter is created with explode: false
+     * 
+     * @param name - Parameter name
+     * @param schema - Optional OpenAPI Schema describing the JSON object.
+     */
+    jsonObject: function(
+      name: string,
+      schema: SchemaObject | ReferenceObject = {
+        type: 'object',
+        additionalProperties: true,
+      },
+      spec?: Partial<ParameterObject>,
+    ) {
+      
+      schema = {
+        type: 'object',
+        ...schema,
+      };
+
+      let content = {
+        "application/json": {
+          schema
+        }
+      }
+
+      return param({
+        name,
+        in: 'query',
+        style: 'deepObject',
+        explode: false,
+        content: content,
+        ...spec,
+      });
+    },
   };
 
+
   /**
    * Header parameter decorator
    */