Add GitHub integration with installation flow

Introduces GitHub integration endpoints and service, including a Redis-backed state store for secure installation flow. Refactors integration code into modular files, appends GitHub routes to the Express app, and updates tests to import the service from its new location.

Author: neSpecc

package.json

@@ -20,7 +20,6 @@
     "test:integration:down": "docker compose -f docker-compose.test.yml down --volumes"
   },
   "devDependencies": {
-    "@octokit/types": "^16.0.0",
     "@shelf/jest-mongodb": "^6.0.2",
     "@swc/core": "^1.3.0",
     "@types/jest": "^26.0.8",
@@ -48,6 +47,7 @@
     "@n1ru4l/json-patch-plus": "^0.2.0",
     "@node-saml/node-saml": "^5.0.1",
     "@octokit/rest": "^22.0.1",
+    "@octokit/types": "^16.0.0",
     "@types/amqp-connection-manager": "^2.0.4",
     "@types/debug": "^4.1.5",
     "@types/escape-html": "^1.0.0",

src/index.ts

@@ -31,6 +31,7 @@ import { requestLogger } from './utils/logger';
 import ReleasesFactory from './models/releasesFactory';
 import RedisHelper from './redisHelper';
 import { appendSsoRoutes } from './sso';
+import { appendGitHubRoutes } from './integrations/github';
 
 /**
  * Option to enable playground
@@ -248,20 +249,26 @@ class HawkAPI {
     await redis.initialize();
 
     /**
-     * Setup shared factories for SSO routes
-     * SSO endpoints don't require per-request DataLoaders isolation,
+     * Setup shared factories for SSO and GitHub integration routes
+     * These endpoints don't require per-request DataLoaders isolation,
      * so we can reuse the same factories instance
      * Created here to avoid duplication with createContext
      */
     // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-    const ssoDataLoaders = new DataLoaders(mongo.databases.hawk!);
-    const ssoFactories = HawkAPI.setupFactories(ssoDataLoaders);
+    const sharedDataLoaders = new DataLoaders(mongo.databases.hawk!);
+    const sharedFactories = HawkAPI.setupFactories(sharedDataLoaders);
 
     /**
      * Append SSO routes to Express app using shared factories
      * Note: This must be called after database connections are established
      */
-    appendSsoRoutes(this.app, ssoFactories);
+    appendSsoRoutes(this.app, sharedFactories);
+
+    /**
+     * Append GitHub integration routes to Express app using shared factories
+     * Note: This must be called after database connections are established
+     */
+    appendGitHubRoutes(this.app, sharedFactories);
 
     await this.server.start();
     this.app.use(graphqlUploadExpress());