feat: add request form decorator

Co-authored-by: imdudu1 <[email protected]>

Author: jbl428

lib/decorators/constants.ts

@@ -3,3 +3,4 @@ export const HTTP_EXCHANGE_METADATA = Symbol("HTTP_EXCHANGE_METADATA");
 export const PATH_VARIABLE_METADATA = Symbol("PATH_VARIABLE_METADATA");
 export const REQUEST_PARAM_METADATA = Symbol("REQUEST_PARAM_METADATA");
 export const REQUEST_BODY_METADATA = Symbol("REQUEST_BODY_METADATA");
+export const REQUEST_FORM_METADATA = Symbol("REQUEST_BODY_METADATA");

lib/decorators/request-form.decorator.spec.ts

@@ -0,0 +1,48 @@
+import { describe, test, expect } from "vitest";
+import { REQUEST_FORM_METADATA } from "./constants";
+import {
+  RequestForm,
+  type RequestFromMetadata,
+} from "./request-form.decorator";
+
+describe("RequestForm", () => {
+  test("should set request form metadata with empty key", () => {
+    // given
+    class TestService {
+      request(@RequestForm() query: { foo: string }): string {
+        return query.foo;
+      }
+    }
+
+    // when
+    const result: RequestFromMetadata = Reflect.getMetadata(
+      REQUEST_FORM_METADATA,
+      TestService.prototype,
+      "request"
+    );
+
+    // then
+    expect(result).toHaveLength(1);
+    expect(result.get(0)).toBeUndefined();
+  });
+
+  test("should set request form metadata with key", () => {
+    // given
+    class TestService {
+      request(@RequestForm("foo") bar: string): string {
+        return bar;
+      }
+    }
+
+    // when
+    const result: RequestFromMetadata = Reflect.getMetadata(
+      REQUEST_FORM_METADATA,
+      TestService.prototype,
+      "request"
+    );
+
+    // then
+    expect(result).toHaveLength(1);
+    expect(result.get(0)).toBe("foo");
+  });
+});

lib/decorators/request-form.decorator.ts

@@ -0,0 +1,24 @@
+import { REQUEST_FORM_METADATA } from "./constants";
+
+export type RequestFromMetadata = Map<number, string | undefined>;
+
+export function RequestForm(key?: string): ParameterDecorator {
+  return (target, propertyKey, parameterIndex) => {
+    if (typeof propertyKey === "undefined") {
+      return;
+    }
+
+    const metadata =
+      Reflect.getMetadata(REQUEST_FORM_METADATA, target, propertyKey) ??
+      new Map();
+
+    metadata.set(parameterIndex, key);
+
+    Reflect.defineMetadata(
+      REQUEST_FORM_METADATA,
+      metadata,
+      target,
+      propertyKey
+    );
+  };
+}