Initial Phoenix Sankofa Cloud setup

- Complete project structure with Next.js frontend
- GraphQL API backend with Apollo Server
- Portal application with NextAuth
- Crossplane Proxmox provider
- GitOps configurations
- CI/CD pipelines
- Testing infrastructure (Vitest, Jest, Go tests)
- Error handling and monitoring
- Security hardening
- UI component library
- Documentation

src/lib/graphql/client.ts

@@ -0,0 +1,58 @@
+import { ApolloClient, InMemoryCache, createHttpLink, from, ApolloLink } from '@apollo/client'
+import { setContext } from '@apollo/client/link/context'
+import { onError } from '@apollo/client/link/error'
+import { handleApiError, getUserFriendlyMessage } from '@/lib/error-handler'
+
+// HTTP Link - configured to use the GraphQL API
+const httpLink = createHttpLink({
+  uri: process.env.NEXT_PUBLIC_GRAPHQL_ENDPOINT || 'http://localhost:4000/graphql',
+})
+
+// Auth Link - for adding authentication headers
+const authLink = setContext((_, { headers }) => {
+  // Get the authentication token from secure storage
+  let token: string | null = null
+  if (typeof window !== 'undefined') {
+    // Try to get from secure storage
+    token = sessionStorage.getItem('auth_token')
+  }
+  
+  return {
+    headers: {
+      ...headers,
+      authorization: token ? `Bearer ${token}` : '',
+    },
+  }
+})
+
+// Error Link - handle GraphQL and network errors
+const errorLink = onError(({ graphQLErrors, networkError, operation, forward }) => {
+  if (graphQLErrors) {
+    graphQLErrors.forEach(({ message, locations, path }) => {
+      const error = handleApiError(new Error(message))
+      console.error(
+        `[GraphQL error]: Message: ${getUserFriendlyMessage(error)}, Location: ${locations}, Path: ${path}`
+      )
+    })
+  }
+
+  if (networkError) {
+    const error = handleApiError(networkError)
+    console.error(`[Network error]: ${getUserFriendlyMessage(error)}`)
+  }
+})
+
+// Create Apollo Client
+export const apolloClient = new ApolloClient({
+  link: from([errorLink, authLink, httpLink]),
+  cache: new InMemoryCache(),
+  defaultOptions: {
+    watchQuery: {
+      errorPolicy: 'all',
+    },
+    query: {
+      errorPolicy: 'all',
+    },
+  },
+})
+