feat: add openApi yaml

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

Author: ulemons

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

@@ -36,7 +36,7 @@ export async function getPackage(req: Request, res: Response): Promise<void> {
 
   const [advisories, stewardshipSummary] = await Promise.all([
     getAdvisoriesByPackageId(qx, pkg.id),
-    pkg.stewardshipId ? getStewardshipSummary(qx, pkg.stewardshipId) : null,
+    pkg.stewardshipId ? getStewardshipSummary(qx, Number(pkg.stewardshipId)) : null,
   ])
 
   ok(res, {

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

@@ -15,18 +15,18 @@ const bodySchema = z.object({
     .string()
     .trim()
     .min(1)
-    .refine((v) => v.startsWith('pkg:'), { message: 'purl must start with pkg:' }),
+    .refine((v) => v.startsWith('pkg:'), { message: 'purl must start with pkg:' })
+    .transform(normalizePurl),
 })
 
 export async function openStewardship(req: Request, res: Response): Promise<void> {
-  const { purl: rawPurl } = validateOrThrow(bodySchema, req.body)
-  const purl = normalizePurl(rawPurl)
+  const { purl } = validateOrThrow(bodySchema, req.body)
 
   const qx = await getPackagesQx()
   const stewardship = await openStewardshipByPurl(qx, purl, req.actor.id)
 
   if (!stewardship) {
-    throw new NotFoundError(`Package not found: ${rawPurl}`)
+    throw new NotFoundError(`Package not found: ${purl}`)
   }
 
   ok(res, { stewardship })