feat: refactor all apis in new path

Signed-off-by: Umberto Sgueglia <usgueglia@contractor.linuxfoundation.org>

Author: ulemons

backend/src/api/public/v1/akrites/index.ts

@@ -0,0 +1,47 @@
+import { Router } from 'express'
+
+import { createRateLimiter } from '@/api/apiRateLimiter'
+import { safeWrap } from '@/middlewares/errorMiddleware'
+
+import { activityFeedHandler } from '../ossprey/activityFeed'
+import { metricsHandler } from '../ossprey/metrics'
+import { packageListHandler } from '../ossprey/packageList'
+import { packageScatterHandler } from '../ossprey/packageScatter'
+import { batchGetStewardship } from '../packages/batchGetStewardship'
+import { getPackage } from '../packages/getPackage'
+import { getPackagesMetrics } from '../packages/getPackagesMetrics'
+import { assignStewardHandler } from '../stewardships/assignSteward'
+import { escalateHandler } from '../stewardships/escalate'
+import { openStewardship } from '../stewardships/openStewardship'
+import { updateStatusHandler } from '../stewardships/updateStatus'
+
+const rateLimiter = createRateLimiter({ max: 60, windowMs: 60 * 1000 })
+
+export function akritesRouter(): Router {
+  const router = Router()
+
+  router.get('/metrics', safeWrap(metricsHandler))
+  // /packages/scatter must be registered before /packages to avoid Express treating 'scatter' as a path param
+  router.get('/packages/scatter', safeWrap(packageScatterHandler))
+  router.get('/packages', safeWrap(packageListHandler))
+  router.get('/activity', safeWrap(activityFeedHandler))
+
+  // --- packages ---
+  router.post(/^\/packages:batch-stewardship\/?$/, rateLimiter, safeWrap(batchGetStewardship))
+  const packagesSubRouter = Router()
+  packagesSubRouter.use(rateLimiter)
+  packagesSubRouter.get('/metrics', safeWrap(getPackagesMetrics))
+  packagesSubRouter.get('/detail', safeWrap(getPackage))
+  router.use('/packages', packagesSubRouter)
+
+  // --- stewardships ---
+  const stewardshipsSubRouter = Router()
+  stewardshipsSubRouter.use(rateLimiter)
+  stewardshipsSubRouter.post('/', safeWrap(openStewardship))
+  stewardshipsSubRouter.put('/:id/steward', safeWrap(assignStewardHandler))
+  stewardshipsSubRouter.put('/:id/escalate', safeWrap(escalateHandler))
+  stewardshipsSubRouter.put('/:id/status', safeWrap(updateStatusHandler))
+  router.use('/stewardships', stewardshipsSubRouter)
+
+  return router
+}

backend/src/api/public/v1/index.ts

@@ -13,6 +13,7 @@ import { oauth2Middleware } from '../middlewares/oauth2Middleware'
 import { staticApiKeyMiddleware } from '../middlewares/staticApiKeyMiddleware'
 
 import { memberOrganizationAffiliationsRouter } from './affiliations'
+import { akritesRouter } from './akrites'
 import { membersRouter } from './members'
 import { organizationsRouter } from './organizations'
 import { osspreyRouter } from './ossprey'
@@ -29,6 +30,7 @@ export function v1Router(): Router {
   router.use('/organizations', oauth2Middleware(AUTH0_CONFIG), organizationsRouter())
   router.use('/affiliations', staticApiKeyMiddleware(), memberOrganizationAffiliationsRouter())
 
+  // TODO[deprecate]: /packages, /stewardships, /ossprey are superseded by /akrites — remove once consumers have migrated
   router.post(
     /^\/packages:batch-stewardship\/?$/,
     oauth2Middleware(AUTH0_CONFIG),
@@ -41,6 +43,8 @@ export function v1Router(): Router {
   router.use('/stewardships', oauth2Middleware(AUTH0_CONFIG), stewardshipsRouter())
   router.use('/ossprey', oauth2Middleware(AUTH0_CONFIG), osspreyRouter())
 
+  router.use('/akrites', oauth2Middleware(AUTH0_CONFIG), akritesRouter())
+
   router.use(() => {
     throw new NotFoundError()
   })

backend/src/api/public/v1/ossprey/index.ts

@@ -7,6 +7,7 @@ import { metricsHandler } from './metrics'
 import { packageListHandler } from './packageList'
 import { packageScatterHandler } from './packageScatter'
 
+// TODO[deprecate]: superseded by /v1/akrites/ossprey — remove once consumers have migrated
 export function osspreyRouter(): Router {
   const router = Router()
 

backend/src/api/public/v1/packages/index.ts

@@ -12,6 +12,7 @@ import { listPackages } from './listPackages'
 
 const rateLimiter = createRateLimiter({ max: 60, windowMs: 60 * 1000 })
 
+// TODO[deprecate]: superseded by /v1/akrites/packages — remove once consumers have migrated
 export function packagesRouter(): Router {
   const router = Router()
 

backend/src/api/public/v1/stewardships/index.ts

@@ -13,6 +13,7 @@ import { updateStatusHandler } from './updateStatus'
 
 const rateLimiter = createRateLimiter({ max: 60, windowMs: 60 * 1000 })
 
+// TODO[deprecate]: superseded by /v1/akrites/stewardships — remove once consumers have migrated
 export function stewardshipsRouter(): Router {
   const router = Router()
 

services/libs/data-access-layer/src/osspckgs/api.ts

@@ -49,6 +49,7 @@ export async function getPackagesByStewardshipPurls(
   )
 }
 
+// TODO[deprecate]: rename to AkritesMetrics once /v1/ossprey is removed
 export interface OsspreyMetrics {
   totalPackages: number
   criticalPackages: number
@@ -60,6 +61,7 @@ export interface OsspreyMetrics {
   escalated: number
 }
 
+// TODO[deprecate]: rename to getAkritesMetrics once /v1/ossprey is removed
 export async function getOsspreyMetrics(qx: QueryExecutor): Promise<OsspreyMetrics> {
   const [counts, stewardRow]: [
     {