feat: add graphql exchange decorator

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

Author: jbl428

lib/builders/http-request.builder.ts

@@ -10,7 +10,7 @@ import {
   REQUEST_HEADER_METADATA,
   REQUEST_PARAM_METADATA,
 } from '../decorators';
-import { type HttpMethod } from '../types/http-method';
+import { type HttpMethod } from '../types';
 
 export class HttpRequestBuilder {
   private baseUrl = '';
@@ -24,6 +24,7 @@ export class HttpRequestBuilder {
     readonly propertyKey: string,
     readonly method: HttpMethod,
     readonly url: string,
+    readonly gqlQuery?: string,
   ) {
     this.pathVariableBuilder = this.getMetadata(PATH_VARIABLE_METADATA);
     this.requestParamBuilder = this.getMetadata(REQUEST_PARAM_METADATA);

lib/decorators/graphql-exchange.decorator.spec.ts

@@ -0,0 +1,30 @@
+import { describe, test, expect } from 'vitest';
+import { HTTP_EXCHANGE_METADATA } from './constants';
+import { GraphQLExchange } from './graphql-exchange.decorator';
+import { type HttpRequestBuilder } from '../builders/http-request.builder';
+
+describe('GraphQLExchange', () => {
+  test('should set graphql exchange metadata', () => {
+    // given
+    class TestService {
+      @GraphQLExchange(`query { hello }`, '/api/graphql')
+      async request(): Promise<string> {
+        return '';
+      }
+    }
+
+    // when
+    const result: HttpRequestBuilder = Reflect.getMetadata(
+      HTTP_EXCHANGE_METADATA,
+      TestService.prototype,
+      'request',
+    );
+
+    // then
+    expect(result.target).toBe(TestService.prototype);
+    expect(result.propertyKey).toBe('request');
+    expect(result.method).toBe('POST');
+    expect(result.url).toBe('/api/graphql');
+    expect(result.gqlQuery).toBe(`query { hello }`);
+  });
+});

lib/decorators/graphql-exchange.decorator.ts

@@ -0,0 +1,17 @@
+import { HTTP_EXCHANGE_METADATA } from './constants';
+import { HttpRequestBuilder } from '../builders/http-request.builder';
+import { type AsyncFunction } from '../types';
+
+export function GraphQLExchange(query: string, url = '/graphql') {
+  return <P extends string>(
+    target: Record<P, AsyncFunction>,
+    propertyKey: P,
+  ) => {
+    Reflect.defineMetadata(
+      HTTP_EXCHANGE_METADATA,
+      new HttpRequestBuilder(target, propertyKey, 'POST', url, query),
+      target,
+      propertyKey,
+    );
+  };
+}

lib/decorators/http-exchange.decorator.ts

@@ -1,8 +1,6 @@
 import { HTTP_EXCHANGE_METADATA } from './constants';
 import { HttpRequestBuilder } from '../builders/http-request.builder';
-import { type HttpMethod } from '../types';
-
-type AsyncFunction = (...args: any[]) => Promise<unknown>;
+import { type AsyncFunction, type HttpMethod } from '../types';
 
 export const HttpExchange =
   (method: HttpMethod, url: string) =>

lib/types/async-function.ts

@@ -0,0 +1 @@
+export type AsyncFunction = (...args: any[]) => Promise<unknown>;

lib/types/index.ts

@@ -1,2 +1,4 @@
 export * from './http-client.interface';
 export * from './http-method';
+export * from './param-decorator-option.interface';
+export * from './async-function';