feat: Add Apollo Server at '/api/graphql'

Author: codinsonn

apps/next/app/(main)/api/graphql/route.ts

@@ -0,0 +1,12 @@
+import type { NextRequest } from 'next/server'
+import { createGraphQLServerHandler } from '@app/core/graphql/graphqlServer'
+
+/* --- Handler --------------------------------------------------------------------------------- */
+
+const handler = createGraphQLServerHandler()
+
+/* --- /api/graphql ---------------------------------------------------------------------------- */
+
+export const GET = (req: NextRequest) => handler(req)
+
+export const POST = (req: NextRequest) => handler(req)

features/app-core/graphql/graphqlServer.ts

@@ -0,0 +1,23 @@
+import { ApolloServer } from '@apollo/server'
+import type { NextRequest } from 'next/server'
+import { startServerAndCreateNextHandler } from '@as-integrations/next'
+import { createRequestContext } from '../middleware/createRequestContext'
+import { schemaBundle } from './schema'
+
+/* --- Apollo Server --------------------------------------------------------------------------- */
+
+export const graphqlServer = new ApolloServer({
+    typeDefs: schemaBundle.typeDefs,
+    resolvers: schemaBundle.resolvers,
+    introspection: true,
+})
+
+/** --- createGraphQLServerHandler() ----------------------------------------------------------- */
+/** -i- Create the apollo graphql server handler for Next.js API router and provides context to resolvers */
+export const createGraphQLServerHandler = () => {
+    return startServerAndCreateNextHandler(graphqlServer, {
+        context: async (req: NextRequest) => {
+            return await createRequestContext({ req })
+        },
+    })
+}

features/app-core/graphql/schema.ts

@@ -0,0 +1,56 @@
+import path from 'path'
+import { fileURLToPath } from 'node:url'
+import { loadFilesSync } from '@graphql-tools/load-files'
+import { mergeTypeDefs, mergeResolvers } from '@graphql-tools/merge'
+import { makeExecutableSchema } from '@graphql-tools/schema'
+import type { RequestContext } from '../middleware/createRequestContext'
+import { healthCheck } from '../resolvers/healthCheck'
+
+/** --- createResolver() ----------------------------------------------------------------------- */
+/** -i- Helper to wrap a resolver function and map context and args to it */
+export const createResolver = <T>(resolver: (input: { args: T, context: RequestContext }) => Promise<unknown>) => {
+    return async (parent: unknown, { args }: { args: T }, context: RequestContext, info: unknown) => {
+        return resolver({ args, context: { ...context, parent, info } })
+    }
+}
+
+/* --- Custom Resolvers ------------------------------------------------------------------------ */
+
+const customResolvers = {
+    Query: {
+        healthCheck: createResolver(healthCheck),
+    },
+}
+
+/** --- createRootResolver() ------------------------------------------------------------------- */
+/** -i- Combine all custom and other (e.g. injected) resolvers */
+export const createRootResolver = () => mergeResolvers([
+    customResolvers,
+    /* other resolvers? */
+])
+
+/** --- createSchemaDefinitions() -------------------------------------------------------------- */
+/** -i- Combine all custom and other (e.g. generated) graphql schema definitions */
+export const createSchemaDefinitions = () => {
+    const currentDir = path.dirname(fileURLToPath(import.meta.url))
+    const rootDir = path.resolve(currentDir, '../../..')
+    const schemaPathPattern = `${rootDir}/(features|packages)/**/*.graphql`
+    const customGraphQLDefinitions = loadFilesSync(schemaPathPattern)
+    return mergeTypeDefs([
+        ...customGraphQLDefinitions,
+        /* other typedefs? */
+    ])
+}
+
+/* --- Schema ---------------------------------------------------------------------------------- */
+
+export const schemaBundle = {
+    typeDefs: createSchemaDefinitions(),
+    resolvers: createRootResolver(),
+}
+
+export const executableSchema = makeExecutableSchema(schemaBundle)
+
+/* --- Exports --------------------------------------------------------------------------------- */
+
+export default executableSchema

features/app-core/package.json

@@ -2,7 +2,12 @@
   "name": "@app/core",
   "version": "1.0.0",
   "private": true,
-  "dependencies": {},
+  "dependencies": {
+    "@apollo/server": "^4.10.2",
+    "@as-integrations/next": "^3.0.0",
+    "@graphql-tools/load-files": "^7.0.0",
+    "graphql-tag": "^2.12.6"
+  },
   "devDependencies": {
     "typescript": "5.3.3"
   },

features/app-core/resolvers/healthCheck.graphql

@@ -0,0 +1,33 @@
+type Query {
+    healthCheck(args: HealthCheckArgs): HealthCheckData!
+}
+
+input HealthCheckArgs {
+    echo: String
+}
+
+type HealthCheckData {
+    echo: String
+    status: String!
+    alive: Boolean!
+    kicking: Boolean!
+    now: String!
+    aliveTime: Float!
+    aliveSince: String!
+    serverTimezone: String!
+    requestHost: String
+    requestProtocol: String
+    requestURL: String
+    baseURL: String
+    apiURL: String
+    port: Int
+    debugPort: Int
+    nodeVersion: String
+    v8Version: String
+    systemArch: String
+    systemPlatform: String
+    systemRelease: String
+    systemFreeMemory: Float
+    systemTotalMemory: Float
+    systemLoadAverage: [Float]
+}