@tmdb-graphql-api/resolvers 0.1.0 → 0.1.1-unstable.0

package/src/queries/tvEpisodeGroups.ts

@@ -1,17 +1,24 @@
-import { GraphQLError, type GraphQLResolveInfo } from 'graphql';
 import { snakeCase } from 'lodash-es';
 import { EPISODE_GROUPS, TV } from '../constants.ts';
-import { type Context, type RawTvEpisodeGroups, type RawTvWithAppendToResponse } from '../types.ts';
+import { buildObjResolver } from '../helpers/buildObjResolver.ts';
+import { type RawTv, type RawTvEpisodeGroups, type RawTvWithAppendToResponse } from '../types.ts';
 
-export const resolveTvEpisodeGroups = async (
-  obj: RawTvWithAppendToResponse & { __headers?: Headers },
-  _args: undefined,
-  { requestID, restClient, setCacheMetadata, tmdbGuestSessionId }: Context,
-  { fieldNodes }: GraphQLResolveInfo
-) => {
-  if (obj.episode_groups && obj.__headers) {
-    setCacheMetadata(`${TV}.${EPISODE_GROUPS}`, obj.__headers);
-    return obj.episode_groups.results;
+const isRawTvWithEpisodeGroups = (
+  obj: RawTv | (RawTvWithAppendToResponse & { __headers?: Headers })
+): obj is RawTvWithAppendToResponse & { __headers: Headers } => snakeCase(EPISODE_GROUPS) in obj && '__headers' in obj;
+
+export const resolveTvEpisodeGroups = buildObjResolver<
+  RawTv | (RawTvWithAppendToResponse & { __headers?: Headers }),
+  RawTvEpisodeGroups['results']
+>(TV, async (obj, ctx) => {
+  const { requestID, restClient, tmdbGuestSessionId } = ctx;
+
+  if (isRawTvWithEpisodeGroups(obj)) {
+    return {
+      data: obj.episode_groups?.results,
+      headers: obj.__headers,
+      source: 'parentNode',
+    };
   }
 
   const { data, errors, headers } = await restClient.tv<RawTvEpisodeGroups>(
@@ -21,13 +28,9 @@ export const resolveTvEpisodeGroups = async (
     { requestID, tmdbGuestSessionId }
   );
 
-  if (errors?.length) {
-    throw new GraphQLError(`Failed to resolve ${TV} ${obj.id} ${EPISODE_GROUPS}.`, {
-      nodes: fieldNodes,
-      originalError: errors[0],
-    });
-  }
-
-  setCacheMetadata(`${TV}.${EPISODE_GROUPS}`, headers);
-  return data!.results;
-};
+  return {
+    data: data?.results,
+    errors,
+    headers,
+  };
+});

package/src/queries/tvExternalIds.test.ts

@@ -6,42 +6,43 @@ import tvExternalIds from '@tmdb-graphql-api/test-utils/responses/themoviedb/tv/
 import { mockFetch } from 'fetch-mocked';
 import { type FetchResponse, type Getta, type ShortcutProperties } from 'getta';
 import { type GraphQLResolveInfo } from 'graphql';
+import { snakeCase } from 'lodash-es';
 import { buildEndpoint } from '../__testUtils__/helpers/buildEndpoint.ts';
+import { createMockLogger } from '../__testUtils__/helpers/createMockLogger.ts';
 import { createRestClient } from '../__testUtils__/helpers/createRestClient.ts';
-import { type Context, type RawTvWithAppendToResponse } from '../types.ts';
+import { EXTERNAL_IDS } from '../constants.ts';
+import { type Context } from '../types.ts';
 import { resolveTvExternalIds } from './tvExternalIds.ts';
 
 const mockedFetch = mockFetch(jest.fn);
 
 describe('resolveTvExternalIds >', () => {
-  let restClient: Getta & ShortcutProperties<ShortcutMethodNames>;
-  const setCacheMetadata = jest.fn();
   const tvId = 1399;
 
-  beforeAll(() => {
-    restClient = createRestClient();
-  });
+  const context = {
+    logger: createMockLogger(jest.fn),
+    restClient: createRestClient(),
+    setCacheMetadata: jest.fn(),
+    tmdbGuestSessionId: 'mock-tmdbGuestSessionId',
+  } as unknown as Context;
+
+  const info = {} as GraphQLResolveInfo;
 
   beforeEach(() => {
-    mockedFetch.mockGetOnce(buildEndpoint(TV_PATH, { id: tvId, type: 'external_ids' }), {
+    mockedFetch.mockGetOnce(buildEndpoint(TV_PATH, { id: tvId, type: snakeCase(EXTERNAL_IDS) }), {
       body: tvExternalIds,
     });
   });
 
   afterEach(async () => {
     mockedFetch.mockReset();
-    await restClient.cache?.clear();
+    await context.restClient.cache?.clear();
+    jest.clearAllMocks();
   });
 
   it('should return the tv external IDs', async () => {
-    await expect(
-      resolveTvExternalIds(
-        tvDetails as unknown as RawTvWithAppendToResponse,
-        undefined,
-        { restClient, setCacheMetadata, tmdbGuestSessionId: 'mock-tmdbGuestSessionId' } as unknown as Context,
-        {} as GraphQLResolveInfo
-      )
-    ).resolves.toMatchSnapshot();
+    // @ts-expect-error minor nested type mismatch
+    await expect(resolveTvExternalIds(tvDetails, undefined, context, info)).resolves.toMatchSnapshot();
   });
 
   describe('when raw tv data has external IDs', () => {
@@ -54,20 +55,18 @@ describe('resolveTvExternalIds >', () => {
 
       await expect(
         resolveTvExternalIds(
+          // @ts-expect-error minor nested type mismatch
           {
             ...tvDetails,
             __headers: new Headers(),
             external_ids: rest,
-          } as unknown as RawTvWithAppendToResponse & {
-            __headers?: Headers;
           },
           undefined,
           {
+            ...context,
             restClient: { tv: tvFetchMock } as unknown as Getta & ShortcutProperties<ShortcutMethodNames>,
-            setCacheMetadata,
-            tmdbGuestSessionId: 'mock-tmdbGuestSessionId',
-          } as unknown as Context,
-          {} as GraphQLResolveInfo
+          },
+          info
         )
       ).resolves.toMatchSnapshot();
     });
@@ -80,20 +79,18 @@ describe('resolveTvExternalIds >', () => {
       const { id, ...rest } = tvExternalIds;
 
       await resolveTvExternalIds(
+        // @ts-expect-error minor nested type mismatch
         {
           ...tvDetails,
           __headers: new Headers(),
           external_ids: rest,
-        } as unknown as RawTvWithAppendToResponse & {
-          __headers?: Headers;
         },
         undefined,
         {
+          ...context,
           restClient: { tv: tvFetchMock } as unknown as Getta & ShortcutProperties<ShortcutMethodNames>,
-          setCacheMetadata,
-          tmdbGuestSessionId: 'mock-tmdbGuestSessionId',
-        } as unknown as Context,
-        {} as GraphQLResolveInfo
+        },
+        info
       );
 
       expect(tvFetchMock).not.toHaveBeenCalled();

package/src/queries/tvExternalIds.ts

@@ -1,17 +1,25 @@
-import { GraphQLError, type GraphQLResolveInfo } from 'graphql';
 import { snakeCase } from 'lodash-es';
+import type { Except } from 'type-fest';
 import { EXTERNAL_IDS, TV } from '../constants.ts';
-import { type Context, type RawTvExternalIds, type RawTvWithAppendToResponse } from '../types.ts';
+import { buildObjResolver } from '../helpers/buildObjResolver.ts';
+import { type RawTv, type RawTvExternalIds, type RawTvWithAppendToResponse } from '../types.ts';
 
-export const resolveTvExternalIds = async (
-  obj: RawTvWithAppendToResponse & { __headers?: Headers },
-  _args: undefined,
-  { requestID, restClient, setCacheMetadata, tmdbGuestSessionId }: Context,
-  { fieldNodes }: GraphQLResolveInfo
-) => {
-  if (obj.external_ids && obj.__headers) {
-    setCacheMetadata(`${TV}.${EXTERNAL_IDS}`, obj.__headers);
-    return obj.external_ids;
+const isRawTvWithExternalIds = (
+  obj: RawTv | (RawTvWithAppendToResponse & { __headers?: Headers })
+): obj is RawTvWithAppendToResponse & { __headers: Headers } => snakeCase(EXTERNAL_IDS) in obj && '__headers' in obj;
+
+export const resolveTvExternalIds = buildObjResolver<
+  RawTv | (RawTvWithAppendToResponse & { __headers?: Headers }),
+  Except<RawTvExternalIds, 'id'>
+>(TV, async (obj, ctx) => {
+  const { requestID, restClient, tmdbGuestSessionId } = ctx;
+
+  if (isRawTvWithExternalIds(obj)) {
+    return {
+      data: obj.external_ids,
+      headers: obj.__headers,
+      source: 'parentNode',
+    };
   }
 
   const { data, errors, headers } = await restClient.tv<RawTvExternalIds>(
@@ -21,14 +29,11 @@ export const resolveTvExternalIds = async (
     { requestID, tmdbGuestSessionId }
   );
 
-  if (errors?.length) {
-    throw new GraphQLError(`Failed to resolve ${TV} ${obj.id} ${EXTERNAL_IDS}.`, {
-      nodes: fieldNodes,
-      originalError: errors[0],
-    });
-  }
+  const { id: tvId, ...rest } = data ?? {};
 
-  setCacheMetadata(`${TV}.${EXTERNAL_IDS}`, headers);
-  const { id: tvId, ...rest } = data!;
-  return rest;
-};
+  return {
+    data: rest,
+    errors,
+    headers,
+  };
+});

package/src/queries/tvImages.test.ts

@@ -7,63 +7,63 @@ import { mockFetch } from 'fetch-mocked';
 import { type FetchResponse, type Getta, type ShortcutProperties } from 'getta';
 import { type GraphQLResolveInfo } from 'graphql';
 import { buildEndpoint } from '../__testUtils__/helpers/buildEndpoint.ts';
+import { createMockLogger } from '../__testUtils__/helpers/createMockLogger.ts';
 import { createRestClient } from '../__testUtils__/helpers/createRestClient.ts';
-import { type Context, type RawTvWithAppendToResponse } from '../types.ts';
+import { IMAGES } from '../constants.ts';
+import { type Context } from '../types.ts';
 import { resolveTvImages } from './tvImages.ts';
 
 const mockedFetch = mockFetch(jest.fn);
 
 describe('resolveTvImages >', () => {
-  let restClient: Getta & ShortcutProperties<ShortcutMethodNames>;
-  const setCacheMetadata = jest.fn();
   const tvId = 1399;
 
-  beforeAll(() => {
-    restClient = createRestClient();
-  });
+  const context = {
+    logger: createMockLogger(jest.fn),
+    restClient: createRestClient(),
+    setCacheMetadata: jest.fn(),
+    tmdbGuestSessionId: 'mock-tmdbGuestSessionId',
+  } as unknown as Context;
 
   beforeEach(() => {
-    mockedFetch.mockGetOnce(buildEndpoint(TV_PATH, { id: tvId, type: 'images' }), {
+    mockedFetch.mockGetOnce(buildEndpoint(TV_PATH, { id: tvId, type: IMAGES }), {
       body: tvImages,
     });
   });
 
   afterEach(async () => {
     mockedFetch.mockReset();
-    await restClient.cache?.clear();
+    await context.restClient.cache?.clear();
+    jest.clearAllMocks();
   });
 
   describe('when fieldName is backdrops', () => {
+    const info = {
+      fieldName: 'backdrops',
+    } as GraphQLResolveInfo;
+
     it('should return the correct response', async () => {
-      await expect(
-        resolveTvImages(
-          tvDetails as unknown as RawTvWithAppendToResponse,
-          undefined,
-          { restClient, setCacheMetadata, tmdbGuestSessionId: 'mock-tmdbGuestSessionId' } as unknown as Context,
-          {
-            fieldName: 'backdrops',
-          } as GraphQLResolveInfo
-        )
-      ).resolves.toMatchSnapshot();
+      // @ts-expect-error minor nested type mismatch
+      await expect(resolveTvImages(tvDetails, undefined, context, info)).resolves.toMatchSnapshot();
     });
   });
 
   describe('when fieldName is posters', () => {
+    const info = {
+      fieldName: 'posters',
+    } as GraphQLResolveInfo;
+
     it('should return the correct response', async () => {
-      await expect(
-        resolveTvImages(
-          tvDetails as unknown as RawTvWithAppendToResponse,
-          undefined,
-          { restClient, setCacheMetadata, tmdbGuestSessionId: 'mock-tmdbGuestSessionId' } as unknown as Context,
-          {
-            fieldName: 'posters',
-          } as GraphQLResolveInfo
-        )
-      ).resolves.toMatchSnapshot();
+      // @ts-expect-error minor nested type mismatch
+      await expect(resolveTvImages(tvDetails, undefined, context, info)).resolves.toMatchSnapshot();
     });
   });
 
   describe('when raw tv data has images', () => {
+    const info = {
+      fieldName: 'logos',
+    } as GraphQLResolveInfo;
+
     it('should return the correct response', async () => {
       const tvFetchMock = jest
         .fn<(...args: PlainArray) => Promise<FetchResponse>>()
@@ -73,18 +73,13 @@ describe('resolveTvImages >', () => {
 
       await expect(
         resolveTvImages(
-          { ...tvImages, __headers: new Headers(), images: rest } as unknown as RawTvWithAppendToResponse & {
-            __headers?: Headers;
-          },
+          { ...tvImages, __headers: new Headers(), images: rest },
           undefined,
           {
+            ...context,
             restClient: { tv: tvFetchMock } as unknown as Getta & ShortcutProperties<ShortcutMethodNames>,
-            setCacheMetadata,
-            tmdbGuestSessionId: 'mock-tmdbGuestSessionId',
-          } as unknown as Context,
-          {
-            fieldName: 'logos',
-          } as GraphQLResolveInfo
+          },
+          info
         )
       ).resolves.toMatchSnapshot();
     });
@@ -97,18 +92,13 @@ describe('resolveTvImages >', () => {
       const { id, ...rest } = tvImages;
 
       await resolveTvImages(
-        { ...tvImages, __headers: new Headers(), images: rest } as unknown as RawTvWithAppendToResponse & {
-          __headers?: Headers;
-        },
+        { ...tvImages, __headers: new Headers(), images: rest },
         undefined,
         {
+          ...context,
           restClient: { tv: tvFetchMock } as unknown as Getta & ShortcutProperties<ShortcutMethodNames>,
-          setCacheMetadata,
-          tmdbGuestSessionId: 'mock-tmdbGuestSessionId',
-        } as unknown as Context,
-        {
-          fieldName: 'logos',
-        } as GraphQLResolveInfo
+        },
+        info
       );
 
       expect(tvFetchMock).not.toHaveBeenCalled();

package/src/queries/tvImages.ts

@@ -1,34 +1,37 @@
-import { GraphQLError, type GraphQLResolveInfo } from 'graphql';
-import { TV } from '../constants.ts';
-import { type Context, type RawTvImages, type RawTvWithAppendToResponse } from '../types.ts';
+import { IMAGES, TV } from '../constants.ts';
+import { buildObjResolver } from '../helpers/buildObjResolver.ts';
+import { type RawTv, type RawTvImages, type RawTvWithAppendToResponse } from '../types.ts';
 
-export const resolveTvImages = async (
-  obj: RawTvWithAppendToResponse & { __headers?: Headers },
-  _args: undefined,
-  { requestID, restClient, setCacheMetadata, tmdbGuestSessionId }: Context,
-  { fieldName, fieldNodes }: GraphQLResolveInfo
-) => {
+const isRawTvWithImages = (
+  obj: RawTv | (RawTvWithAppendToResponse & { __headers?: Headers })
+): obj is RawTvWithAppendToResponse & { __headers: Headers } => IMAGES in obj && '__headers' in obj;
+
+export const resolveTvImages = buildObjResolver<
+  RawTv | (RawTvWithAppendToResponse & { __headers?: Headers }),
+  RawTvImages['posters'] | RawTvImages['logos'] | RawTvImages['backdrops']
+>(TV, async (obj, ctx, info) => {
+  const { requestID, restClient, tmdbGuestSessionId } = ctx;
+  const { fieldName } = info;
   const typedFieldName = fieldName as 'backdrops' | 'logos' | 'posters';
 
-  if (obj.images && obj.__headers) {
-    setCacheMetadata(`${TV}.${typedFieldName}`, obj.__headers);
-    return obj.images[typedFieldName];
+  if (isRawTvWithImages(obj)) {
+    return {
+      data: obj.images?.[typedFieldName],
+      headers: obj.__headers,
+      source: 'parentNode',
+    };
   }
 
   const { data, errors, headers } = await restClient.tv<RawTvImages>(
     {
-      pathTemplateData: { id: obj.id, type: 'images' },
+      pathTemplateData: { id: obj.id, type: IMAGES },
     },
     { requestID, tmdbGuestSessionId }
   );
 
-  if (errors?.length) {
-    throw new GraphQLError(`Failed to resolve ${TV} ${obj.id} ${typedFieldName}.`, {
-      nodes: fieldNodes,
-      originalError: errors[0],
-    });
-  }
-
-  setCacheMetadata(`${TV}.${typedFieldName}`, headers);
-  return data![typedFieldName];
-};
+  return {
+    data: data?.[typedFieldName],
+    errors,
+    headers,
+  };
+});

package/src/queries/tvKeywords.test.ts

@@ -7,41 +7,41 @@ import { mockFetch } from 'fetch-mocked';
 import { type FetchResponse, type Getta, type ShortcutProperties } from 'getta';
 import { type GraphQLResolveInfo } from 'graphql';
 import { buildEndpoint } from '../__testUtils__/helpers/buildEndpoint.ts';
+import { createMockLogger } from '../__testUtils__/helpers/createMockLogger.ts';
 import { createRestClient } from '../__testUtils__/helpers/createRestClient.ts';
-import { type Context, type RawTvWithAppendToResponse } from '../types.ts';
+import { KEYWORDS } from '../constants.ts';
+import { type Context } from '../types.ts';
 import { resolveTvKeywords } from './tvKeywords.ts';
 
 const mockedFetch = mockFetch(jest.fn);
 
 describe('resolveTvKeywords >', () => {
-  let restClient: Getta & ShortcutProperties<ShortcutMethodNames>;
-  const setCacheMetadata = jest.fn();
   const tvId = 1399;
 
-  beforeAll(() => {
-    restClient = createRestClient();
-  });
+  const context = {
+    logger: createMockLogger(jest.fn),
+    restClient: createRestClient(),
+    setCacheMetadata: jest.fn(),
+    tmdbGuestSessionId: 'mock-tmdbGuestSessionId',
+  } as unknown as Context;
+
+  const info = {} as GraphQLResolveInfo;
 
   beforeEach(() => {
-    mockedFetch.mockGetOnce(buildEndpoint(TV_PATH, { id: tvId, type: 'keywords' }), {
+    mockedFetch.mockGetOnce(buildEndpoint(TV_PATH, { id: tvId, type: KEYWORDS }), {
       body: tvKeywords,
     });
   });
 
   afterEach(async () => {
     mockedFetch.mockReset();
-    await restClient.cache?.clear();
+    await context.restClient.cache?.clear();
+    jest.clearAllMocks();
   });
 
   it('should return the tv keywords', async () => {
-    await expect(
-      resolveTvKeywords(
-        tvDetails as unknown as RawTvWithAppendToResponse,
-        undefined,
-        { restClient, setCacheMetadata, tmdbGuestSessionId: 'mock-tmdbGuestSessionId' } as unknown as Context,
-        {} as GraphQLResolveInfo
-      )
-    ).resolves.toMatchSnapshot();
+    // @ts-expect-error minor nested type mismatch
+    await expect(resolveTvKeywords(tvDetails, undefined, context, info)).resolves.toMatchSnapshot();
   });
 
   describe('when raw tv data has keywords', () => {
@@ -54,20 +54,18 @@ describe('resolveTvKeywords >', () => {
 
       await expect(
         resolveTvKeywords(
+          // @ts-expect-error minor nested type mismatch
           {
             ...tvDetails,
             __headers: new Headers(),
             keywords: rest,
-          } as unknown as RawTvWithAppendToResponse & {
-            __headers?: Headers;
           },
           undefined,
           {
+            ...context,
             restClient: { tv: tvFetchMock } as unknown as Getta & ShortcutProperties<ShortcutMethodNames>,
-            setCacheMetadata,
-            tmdbGuestSessionId: 'mock-tmdbGuestSessionId',
-          } as unknown as Context,
-          {} as GraphQLResolveInfo
+          },
+          info
         )
       ).resolves.toMatchSnapshot();
     });
@@ -80,20 +78,18 @@ describe('resolveTvKeywords >', () => {
       const { id, ...rest } = tvKeywords;
 
       await resolveTvKeywords(
+        // @ts-expect-error minor nested type mismatch
         {
           ...tvDetails,
           __headers: new Headers(),
           keywords: rest,
-        } as unknown as RawTvWithAppendToResponse & {
-          __headers?: Headers;
         },
         undefined,
         {
+          ...context,
           restClient: { tv: tvFetchMock } as unknown as Getta & ShortcutProperties<ShortcutMethodNames>,
-          setCacheMetadata,
-          tmdbGuestSessionId: 'mock-tmdbGuestSessionId',
-        } as unknown as Context,
-        {} as GraphQLResolveInfo
+        },
+        info
       );
 
       expect(tvFetchMock).not.toHaveBeenCalled();

package/src/queries/tvKeywords.ts

@@ -1,16 +1,23 @@
-import { GraphQLError, type GraphQLResolveInfo } from 'graphql';
 import { KEYWORDS, TV } from '../constants.ts';
-import { type Context, type RawTvKeywords, type RawTvWithAppendToResponse } from '../types.ts';
+import { buildObjResolver } from '../helpers/buildObjResolver.ts';
+import { type RawTv, type RawTvKeywords, type RawTvWithAppendToResponse } from '../types.ts';
 
-export const resolveTvKeywords = async (
-  obj: RawTvWithAppendToResponse & { __headers?: Headers },
-  _args: undefined,
-  { requestID, restClient, setCacheMetadata, tmdbGuestSessionId }: Context,
-  { fieldNodes }: GraphQLResolveInfo
-) => {
-  if (obj.keywords && obj.__headers) {
-    setCacheMetadata(`${TV}.${KEYWORDS}`, obj.__headers);
-    return obj.keywords.results;
+const isRawTvWithKeywords = (
+  obj: RawTv | (RawTvWithAppendToResponse & { __headers?: Headers })
+): obj is RawTvWithAppendToResponse & { __headers: Headers } => KEYWORDS in obj && '__headers' in obj;
+
+export const resolveTvKeywords = buildObjResolver<
+  RawTv | (RawTvWithAppendToResponse & { __headers?: Headers }),
+  RawTvKeywords['results']
+>(TV, async (obj, ctx) => {
+  const { requestID, restClient, tmdbGuestSessionId } = ctx;
+
+  if (isRawTvWithKeywords(obj)) {
+    return {
+      data: obj.keywords?.results,
+      headers: obj.__headers,
+      source: 'parentNode',
+    };
   }
 
   const { data, errors, headers } = await restClient.tv<RawTvKeywords>(
@@ -20,13 +27,9 @@ export const resolveTvKeywords = async (
     { requestID, tmdbGuestSessionId }
   );
 
-  if (errors?.length) {
-    throw new GraphQLError(`Failed to resolve ${TV} ${obj.id} ${KEYWORDS}.`, {
-      nodes: fieldNodes,
-      originalError: errors[0],
-    });
-  }
-
-  setCacheMetadata(`${TV}.${KEYWORDS}`, headers);
-  return data?.results;
-};
+  return {
+    data: data?.results,
+    errors,
+    headers,
+  };
+});