Add forked from list item on package view

Author: supersonicbyte

Sources/App/Controllers/API/API+PackageController+GetRoute+Model.swift

@@ -50,6 +50,7 @@ extension API.PackageController.GetRoute {
         var releaseReferences: [App.Version.Kind: App.Reference]
         var fundingLinks: [FundingLink]
         var swift6Readiness: Swift6Readiness?
+        var forkedFromURL: String?
 
         internal init(packageId: Package.Id,
                       repositoryOwner: String,
@@ -81,7 +82,8 @@ extension API.PackageController.GetRoute {
                       releaseReference: App.Reference?,
                       preReleaseReference: App.Reference?,
                       fundingLinks: [FundingLink] = [],
-                      swift6Readiness: Swift6Readiness?
+                      swift6Readiness: Swift6Readiness?,
+                      forkedFromURL: String?
             ) {
             self.packageId = packageId
             self.repositoryOwner = repositoryOwner
@@ -123,6 +125,7 @@ extension API.PackageController.GetRoute {
             }()
             self.fundingLinks = fundingLinks
             self.swift6Readiness = swift6Readiness
+            self.forkedFromURL = forkedFromURL
         }
 
         init?(result: API.PackageController.PackageResult,
@@ -132,7 +135,8 @@ extension API.PackageController.GetRoute {
               swiftVersionBuildInfo: BuildInfo<CompatibilityMatrix.SwiftVersionCompatibility>?,
               platformBuildInfo: BuildInfo<CompatibilityMatrix.PlatformCompatibility>?,
               weightedKeywords: [WeightedKeyword] = [],
-              swift6Readiness: Swift6Readiness?) {
+              swift6Readiness: Swift6Readiness?,
+              forkedFromURL: String?) {
             // we consider certain attributes as essential and return nil (raising .notFound)
             let repository = result.repository
             guard
@@ -177,7 +181,8 @@ extension API.PackageController.GetRoute {
                 releaseReference: result.releaseVersion?.reference,
                 preReleaseReference: result.preReleaseVersion?.reference,
                 fundingLinks: result.repository.fundingLinks,
-                swift6Readiness: swift6Readiness
+                swift6Readiness: swift6Readiness,
+                forkedFromURL: forkedFromURL
             )
 
         }

Sources/App/Controllers/API/API+PackageController+GetRoute.swift

@@ -30,6 +30,10 @@ extension API.PackageController {
             let packageResult = try await PackageResult.query(on: database,
                                                               owner: owner,
                                                               repository: repository)
+            
+            let forkedFromURL = try await self.fetchForkedFromURL(on: database,
+                                                                  repository: packageResult.repository)
+            
             async let weightedKeywords = WeightedKeyword.query(
                 on: database, keywords: packageResult.repository.keywords
             )
@@ -55,7 +59,8 @@ extension API.PackageController {
                     swiftVersionBuildInfo: buildInfo.swiftVersion,
                     platformBuildInfo: buildInfo.platform,
                     weightedKeywords: weightedKeywords,
-                    swift6Readiness: buildInfo.swift6Readiness
+                    swift6Readiness: buildInfo.swift6Readiness,
+                    forkedFromURL: forkedFromURL
                 ),
                 let schema = API.PackageSchema(result: packageResult)
             else {
@@ -64,6 +69,20 @@ extension API.PackageController {
 
             return (model, schema)
         }
+        
+        private static func fetchForkedFromURL(on database: Database, repository: Repository) async throws -> String? {
+            if let forkedFrom = repository.forkedFrom {
+                switch forkedFrom {
+                case .parentId(let id):
+                    let repo = try await Repository.find(on: database, for: id)
+                    guard let owner = repo?.owner, let name = repo?.name else { return nil }
+                    return SiteURL.package(.value(owner), .value(name), nil).absoluteURL()
+                case .parentURL(let string):
+                    return string
+                }
+            }
+            return nil
+        }
     }
 }
 

Sources/App/Controllers/API/Types+WithExample.swift

@@ -247,7 +247,8 @@ extension API.PackageController.GetRoute.Model: WithExample {
               defaultBranchReference: .branch("main"),
               releaseReference: .tag(1, 2, 3, "1.2.3"),
               preReleaseReference: nil,
-              swift6Readiness: nil)
+              swift6Readiness: nil, 
+              forkedFromURL: nil)
     }
 }
 

Sources/App/Models/Repository.swift

@@ -224,6 +224,13 @@ final class Repository: @unchecked Sendable, Model, Content {
             .filter(\.$package.$id == pkgId)
             .first() ?? Repository(packageId: pkgId)
     }
+    
+    static func find(on database: Database, for packageId: Package.Id) async throws -> Repository? {
+        return try await Repository.query(on: database)
+            .filter(\.$package.$id == packageId)
+            .first()
+    }
+
 }
 
 

Sources/App/Views/PackageController/GetRoute.Model+ext.swift

@@ -181,6 +181,25 @@ extension API.PackageController.GetRoute.Model {
             return .empty
         }
     }
+    
+    func forkedListItem() -> Node<HTML.ListContext> {
+        if let forkedFromURL {
+            let repoURLNode: Node<HTML.BodyContext> = .a(
+                .href(forkedFromURL),
+                .text("repository")
+            )
+            return .li(
+                .class("forked"),
+                .group(
+                    .text("Forked from "),
+                    repoURLNode,
+                    .text(".")
+                )
+            )
+        } else {
+            return .empty
+        }
+    }
 
     func binaryTargetsItem() -> Node<HTML.ListContext> {
         guard hasBinaryTargets else { return .empty }

Sources/App/Views/PackageController/PackageShow+View.swift

@@ -167,6 +167,7 @@ extension PackageShow {
                 .ul(
                     .class("main-metadata"),
                     model.archivedListItem(),
+                    model.forkedListItem(),
                     model.authorsListItem(),
                     model.binaryTargetsItem(),
                     model.historyListItem(),