add an interface for hiding/unhiding packages, exclude hidden packages from the search index and the activity feed

tayloraswift · tayloraswift · commit 705d897ec4c6 · 2023-12-20T22:38:35.000Z
diff --git a/Package.resolved b/Package.resolved
diff --git a/Sources/Swiftinit/Tree/Swiftinit.API.Post.swift b/Sources/Swiftinit/Tree/Swiftinit.API.Post.swift
@@ -3,9 +3,11 @@ extension Swiftinit.API
     @frozen public
     enum Post:String, Swiftinit.Method
     {
-        case alignPackage = "align-package"
-        case indexRepo = "index-repo"
-        case indexRepoTag = "index-repo-tag"
+        case packageAlign = "package-align"
+        case packageConfig = "package-config"
+        case packageIndex = "package-index"
+        case packageIndexTag = "package-index-tag"
+
         case uplinkAll = "uplink-all"
         case uplink
         case unlink
diff --git a/Sources/SwiftinitPages/Surfaces/Administration/Swiftinit.AdminPage.swift b/Sources/SwiftinitPages/Surfaces/Administration/Swiftinit.AdminPage.swift
@@ -105,7 +105,7 @@ extension Swiftinit.AdminPage:Swiftinit.AdministrativePage
         main[.form]
         {
             $0.enctype = "\(MediaType.application(.x_www_form_urlencoded))"
-            $0.action = "\(Swiftinit.API[.indexRepo])"
+            $0.action = "\(Swiftinit.API[.packageIndex])"
             $0.method = "post"
         }
             content:
diff --git a/Sources/SwiftinitPages/Surfaces/Editions/Swiftinit.TagsPage.swift b/Sources/SwiftinitPages/Surfaces/Editions/Swiftinit.TagsPage.swift
@@ -236,8 +236,10 @@ extension Swiftinit.TagsPage:Swiftinit.ApplicationPage
                     {
                         $0[.span] { $0.class = "placeholder" } = "none"
                     }
-
                 }
+
+                $0[.dt] = "Hidden"
+                $0[.dd] = self.package.hidden ? "yes" : "no"
             }
 
             guard self.user?.maintains(package: self.package) ?? !format.secure
@@ -249,7 +251,7 @@ extension Swiftinit.TagsPage:Swiftinit.ApplicationPage
             $0[.form]
             {
                 $0.enctype = "\(MediaType.application(.x_www_form_urlencoded))"
-                $0.action = "\(Swiftinit.API[.alignPackage])"
+                $0.action = "\(Swiftinit.API[.packageAlign])"
                 $0.method = "post"
             }
                 content:
@@ -260,7 +262,7 @@ extension Swiftinit.TagsPage:Swiftinit.ApplicationPage
                     {
                         $0.type = "hidden"
                         $0.name = "package"
-                        $0.value = "\(self.package.symbol)"
+                        $0.value = "\(self.package.id)"
                     }
 
                     $0[.input]
@@ -296,7 +298,39 @@ extension Swiftinit.TagsPage:Swiftinit.ApplicationPage
             $0[.form]
             {
                 $0.enctype = "\(MediaType.application(.x_www_form_urlencoded))"
-                $0.action = "\(Swiftinit.API[.indexRepoTag])"
+                $0.action = "\(Swiftinit.API[.packageConfig])"
+                $0.method = "post"
+            }
+                content:
+            {
+                $0[.p]
+                {
+                    $0[.input]
+                    {
+                        $0.type = "hidden"
+                        $0.name = "package"
+                        $0.value = "\(self.package.id)"
+                    }
+
+                    $0[.input]
+                    {
+                        $0.type = "hidden"
+                        $0.name = "hidden"
+                        $0.value = self.package.hidden ? "false" : "true"
+                    }
+                }
+                $0[.p]
+                {
+                    $0[.button] { $0.type = "submit" } = self.package.hidden
+                        ? "Unhide Package"
+                        : "Hide Package"
+                }
+            }
+
+            $0[.form]
+            {
+                $0.enctype = "\(MediaType.application(.x_www_form_urlencoded))"
+                $0.action = "\(Swiftinit.API[.packageIndexTag])"
                 $0.method = "post"
             }
                 content:
@@ -307,7 +341,7 @@ extension Swiftinit.TagsPage:Swiftinit.ApplicationPage
                     {
                         $0.type = "hidden"
                         $0.name = "package"
-                        $0.value = "\(self.package.symbol)"
+                        $0.value = "\(self.package.id)"
                     }
 
                     $0[.input]
@@ -319,7 +353,7 @@ extension Swiftinit.TagsPage:Swiftinit.ApplicationPage
                 }
                 $0[.p]
                 {
-                    $0[.button] { $0.type = "submit" } = "Index GitHub Tag"
+                    $0[.button] { $0.type = "submit" } = "Index Package Tag (GitHub)"
                 }
             }
         }
diff --git a/Sources/SwiftinitServer/Endpoints/Interactive/Swiftinit.PackageConfigEndpoint.swift b/Sources/SwiftinitServer/Endpoints/Interactive/Swiftinit.PackageConfigEndpoint.swift
@@ -0,0 +1,51 @@
+extension Swiftinit.PackageConfigEndpoint
+{
+    enum Update
+    {
+        case hidden(Bool)
+    }
+}
+
+import HTTP
+import MongoDB
+import UnidocDB
+
+extension Swiftinit
+{
+    struct PackageConfigEndpoint:Sendable
+    {
+        let package:Unidoc.Package
+        let update:Update
+
+        init(package:Unidoc.Package, update:Update)
+        {
+            self.package = package
+            self.update = update
+        }
+    }
+}
+extension Swiftinit.PackageConfigEndpoint:RestrictedEndpoint
+{
+    func load(from server:borrowing Swiftinit.Server) async throws -> HTTP.ServerResponse?
+    {
+        let session:Mongo.Session = try await .init(from: server.db.sessions)
+        let updated:Unidoc.PackageMetadata?
+        switch self.update
+        {
+        case .hidden(let hidden):
+            updated = try await server.db.packages.update(package: self.package,
+                hidden: hidden,
+                with: session)
+        }
+
+        guard
+        let updated:Unidoc.PackageMetadata
+        else
+        {
+            return .notFound("No such package")
+        }
+
+        try await server.db.unidoc.rebuildPackageList(with: session)
+        return .redirect(.see(other: "\(Swiftinit.Tags[updated.symbol])"))
+    }
+}
diff --git a/Sources/SwiftinitServer/Endpoints/Interactive/Swiftinit.PackageIndexEndpoint.swift b/Sources/SwiftinitServer/Endpoints/Interactive/Swiftinit.PackageIndexEndpoint.swift
@@ -9,7 +9,7 @@ import UnidocRecords
 
 extension Swiftinit
 {
-    struct IndexRepoEndpoint:Sendable
+    struct PackageIndexEndpoint:Sendable
     {
         let owner:String
         let repo:String
@@ -21,7 +21,7 @@ extension Swiftinit
         }
     }
 }
-extension Swiftinit.IndexRepoEndpoint:RestrictedEndpoint
+extension Swiftinit.PackageIndexEndpoint:RestrictedEndpoint
 {
     func load(from server:borrowing Swiftinit.Server) async throws -> HTTP.ServerResponse?
     {
diff --git a/Sources/SwiftinitServer/Endpoints/Interactive/Swiftinit.PackageIndexTagEndpoint.swift b/Sources/SwiftinitServer/Endpoints/Interactive/Swiftinit.PackageIndexTagEndpoint.swift
@@ -9,19 +9,19 @@ import UnidocRecords
 
 extension Swiftinit
 {
-    struct IndexRepoTagEndpoint:Sendable
+    struct PackageIndexTagEndpoint:Sendable
     {
-        let package:Symbol.Package
+        let package:Unidoc.Package
         let tag:String
 
-        init(package:Symbol.Package, tag:String)
+        init(package:Unidoc.Package, tag:String)
         {
             self.package = package
             self.tag = tag
         }
     }
 }
-extension Swiftinit.IndexRepoTagEndpoint:RestrictedEndpoint
+extension Swiftinit.PackageIndexTagEndpoint:RestrictedEndpoint
 {
     func load(from server:borrowing Swiftinit.Server) async throws -> HTTP.ServerResponse?
     {
@@ -35,8 +35,7 @@ extension Swiftinit.IndexRepoTagEndpoint:RestrictedEndpoint
         let session:Mongo.Session = try await .init(from: server.db.sessions)
 
         guard
-        let package:Unidoc.PackageMetadata = try await server.db.unidoc.package(
-            named: self.package,
+        let package:Unidoc.PackageMetadata = try await server.db.packages.find(id: self.package,
             with: session)
         else
         {
diff --git a/Sources/SwiftinitServer/Endpoints/Interactive/Swiftinit.RobotsEndpoint.swift b/Sources/SwiftinitServer/Endpoints/Interactive/Swiftinit.RobotsEndpoint.swift
@@ -46,6 +46,7 @@ extension Swiftinit.RobotsEndpoint:PublicEndpoint
             User-agent: *
             Disallow: /admin/
             Disallow: /auth/
+            Disallow: /reference/
 
             """)
     }
diff --git a/Sources/SwiftinitServer/Endpoints/Procedural/Swiftinit.GlobalUplinkEndpoint.swift b/Sources/SwiftinitServer/Endpoints/Procedural/Swiftinit.GlobalUplinkEndpoint.swift
@@ -25,6 +25,6 @@ extension Swiftinit.GlobalUplinkEndpoint:NonblockingEndpoint
         session:Mongo.Session,
         status:Status) async
     {
-        try? await server.db.unidoc.rebuild(queue: self.queue, with: session)
+        try? await server.db.unidoc.rebuildVolumes(queue: self.queue, with: session)
     }
 }
diff --git a/Sources/SwiftinitServer/Endpoints/Procedural/Swiftinit.PackageAlignEndpoint.swift b/Sources/SwiftinitServer/Endpoints/Procedural/Swiftinit.PackageAlignEndpoint.swift
@@ -8,11 +8,11 @@ extension Swiftinit
 {
     struct PackageAlignEndpoint:Sendable
     {
-        let package:Symbol.Package
+        let package:Unidoc.Package
         let realm:String?
         let force:Bool
 
-        init(package:Symbol.Package,
+        init(package:Unidoc.Package,
             realm:String?,
             force:Bool)
         {
@@ -57,8 +57,7 @@ extension Swiftinit.PackageAlignEndpoint:NonblockingEndpoint
         }
 
         guard
-        let package:Unidoc.PackageMetadata = try await server.db.unidoc.package(
-            named: self.package,
+        let package:Unidoc.PackageMetadata = try await server.db.packages.find(id: self.package,
             with: session)
         else
         {
diff --git a/Sources/SwiftinitServer/Plugins/GitHubPlugin.Crawler.swift b/Sources/SwiftinitServer/Plugins/GitHubPlugin.Crawler.swift
@@ -142,6 +142,11 @@ extension GitHubPlugin.Crawler
                 }
             }
 
+            if  package.hidden
+            {
+                continue
+            }
+
             if  let interesting:String = release ?? prerelease,
                     response.repo.visibleInFeed
             {
diff --git a/Sources/SwiftinitServer/Swiftinit.AnyEndpoint.swift b/Sources/SwiftinitServer/Swiftinit.AnyEndpoint.swift
@@ -308,30 +308,42 @@ extension Swiftinit.AnyEndpoint
 
             switch trunk
             {
-            case .alignPackage:
-                if  let package:String = form["package"]
+            case .packageAlign:
+                if  let package:String = form["package"],
+                    let package:Unidoc.Package = .init(package)
                 {
                     return .procedural(Swiftinit.PackageAlignEndpoint.init(
-                        package: .init(package),
+                        package: package,
                         realm: form["realm"],
                         force: form["force"] == "true"))
                 }
 
-            case .indexRepo:
+            case .packageConfig:
+                if  let package:String = form["package"],
+                    let package:Unidoc.Package = .init(package),
+                    let hidden:String = form["hidden"],
+                    let hidden:Bool = .init(hidden)
+                {
+                    return .interactive(Swiftinit.PackageConfigEndpoint.init(
+                        package: package,
+                        update: .hidden(hidden)))
+                }
+
+            case .packageIndex:
                 if  let owner:String = form["owner"],
                     let repo:String = form["repo"]
                 {
-                    return .interactive(Swiftinit.IndexRepoEndpoint.init(
+                    return .interactive(Swiftinit.PackageIndexEndpoint.init(
                         owner: owner,
                         repo: repo))
                 }
 
-            case .indexRepoTag:
+            case .packageIndexTag:
                 if  let package:String = form["package"],
+                    let package:Unidoc.Package = .init(package),
                     let tag:String = form["tag"]
                 {
-                    let package:Symbol.Package = .init(package)
-                    return .interactive(Swiftinit.IndexRepoTagEndpoint.init(
+                    return .interactive(Swiftinit.PackageIndexTagEndpoint.init(
                         package: package,
                         tag: tag))
                 }
diff --git a/Sources/UnidocDB/Mongo.CollectionModel.swift b/Sources/UnidocDB/Mongo.CollectionModel.swift
@@ -388,19 +388,19 @@ extension Mongo.CollectionModel
     /// Sets the value of the specified field in the document with the specified identifier,
     /// returning true if the document was modified, false if the document was not modified,
     /// and nil if the document was not found.
-    @discardableResult
+    private
     func update(field:Mongo.KeyPath,
         of target:Element.ID,
-        to value:__owned some BSONEncodable,
+        to value:some BSONEncodable,
         with session:Mongo.Session) async throws -> Bool?
     {
         try await self.update(field: field, by: "_id", of: target, to: value, with: session)
     }
-    @discardableResult
+    private
     func update(field:Mongo.KeyPath,
         by index:Mongo.KeyPath,
-        of key:__owned some BSONEncodable,
-        to value:__owned some BSONEncodable,
+        of key:some BSONEncodable,
+        to value:some BSONEncodable,
         with session:Mongo.Session) async throws -> Bool?
     {
         let response:Mongo.UpdateResponse<Element.ID> = try await session.run(
@@ -420,6 +420,37 @@ extension Mongo.CollectionModel
     }
 }
 
+extension Mongo.CollectionModel where Element:MongoMasterCodingModel
+{
+    @discardableResult
+    func update(field:Element.CodingKey,
+        of target:Element.ID,
+        to value:some BSONEncodable,
+        with session:Mongo.Session) async throws -> Bool?
+    {
+        try await self.update(
+            field: Element[field],
+            of: target,
+            to: value,
+            with: session)
+    }
+
+    @discardableResult
+    func update(field:Element.CodingKey,
+        by index:Element.CodingKey,
+        of key:some BSONEncodable,
+        to value:some BSONEncodable,
+        with session:Mongo.Session) async throws -> Bool?
+    {
+        try await self.update(
+            field: Element[field],
+            by: Element[index],
+            of: key,
+            to: value,
+            with: session)
+    }
+}
+
 extension Mongo.CollectionModel
 {
     /// Deletes up to one document having the specified identifier, returning true if a
diff --git a/Sources/UnidocDB/Packages/UnidocDatabase.Packages.swift b/Sources/UnidocDB/Packages/UnidocDatabase.Packages.swift
diff --git a/Sources/UnidocDB/UnidocDatabase.swift b/Sources/UnidocDB/UnidocDatabase.swift

Original file line number	Diff line number	Diff line change
`@@ -105,7 +105,7 @@ extension Swiftinit.AdminPage:Swiftinit.AdministrativePage`
`105`	`105`	`main[.form]`
`106`	`106`	`{`
`107`	`107`	`$0.enctype = "\(MediaType.application(.x_www_form_urlencoded))"`
`108`		`- $0.action = "\(Swiftinit.API[.indexRepo])"`
	`108`	`+ $0.action = "\(Swiftinit.API[.packageIndex])"`
`109`	`109`	`$0.method = "post"`
`110`	`110`	`}`
`111`	`111`	`content:`
Original file line number	Diff line number	Diff line change
`@@ -236,8 +236,10 @@ extension Swiftinit.TagsPage:Swiftinit.ApplicationPage`
`236`	`236`	`{`
`237`	`237`	`$0[.span] { $0.class = "placeholder" } = "none"`
`238`	`238`	`}`
`239`		`-`
`240`	`239`	`}`
	`240`	`+`
	`241`	`+ $0[.dt] = "Hidden"`
	`242`	`+ $0[.dd] = self.package.hidden ? "yes" : "no"`
`241`	`243`	`}`
`242`	`244`
`243`	`245`	`guard self.user?.maintains(package: self.package) ?? !format.secure`
`@@ -249,7 +251,7 @@ extension Swiftinit.TagsPage:Swiftinit.ApplicationPage`
`249`	`251`	`$0[.form]`
`250`	`252`	`{`
`251`	`253`	`$0.enctype = "\(MediaType.application(.x_www_form_urlencoded))"`
`252`		`- $0.action = "\(Swiftinit.API[.alignPackage])"`
	`254`	`+ $0.action = "\(Swiftinit.API[.packageAlign])"`
`253`	`255`	`$0.method = "post"`
`254`	`256`	`}`
`255`	`257`	`content:`
`@@ -260,7 +262,7 @@ extension Swiftinit.TagsPage:Swiftinit.ApplicationPage`
`260`	`262`	`{`
`261`	`263`	`$0.type = "hidden"`
`262`	`264`	`$0.name = "package"`
`263`		`- $0.value = "\(self.package.symbol)"`
	`265`	`+ $0.value = "\(self.package.id)"`
`264`	`266`	`}`
`265`	`267`
`266`	`268`	`$0[.input]`
`@@ -296,7 +298,39 @@ extension Swiftinit.TagsPage:Swiftinit.ApplicationPage`
`296`	`298`	`$0[.form]`
`297`	`299`	`{`
`298`	`300`	`$0.enctype = "\(MediaType.application(.x_www_form_urlencoded))"`
`299`		`- $0.action = "\(Swiftinit.API[.indexRepoTag])"`
	`301`	`+ $0.action = "\(Swiftinit.API[.packageConfig])"`
	`302`	`+ $0.method = "post"`
	`303`	`+ }`
	`304`	`+ content:`
	`305`	`+ {`
	`306`	`+ $0[.p]`
	`307`	`+ {`
	`308`	`+ $0[.input]`
	`309`	`+ {`
	`310`	`+ $0.type = "hidden"`
	`311`	`+ $0.name = "package"`
	`312`	`+ $0.value = "\(self.package.id)"`
	`313`	`+ }`
	`314`	`+`
	`315`	`+ $0[.input]`
	`316`	`+ {`
	`317`	`+ $0.type = "hidden"`
	`318`	`+ $0.name = "hidden"`
	`319`	`+ $0.value = self.package.hidden ? "false" : "true"`
	`320`	`+ }`
	`321`	`+ }`
	`322`	`+ $0[.p]`
	`323`	`+ {`
	`324`	`+ $0[.button] { $0.type = "submit" } = self.package.hidden`
	`325`	`+ ? "Unhide Package"`
	`326`	`+ : "Hide Package"`
	`327`	`+ }`
	`328`	`+ }`
	`329`	`+`
	`330`	`+ $0[.form]`
	`331`	`+ {`
	`332`	`+ $0.enctype = "\(MediaType.application(.x_www_form_urlencoded))"`
	`333`	`+ $0.action = "\(Swiftinit.API[.packageIndexTag])"`
`300`	`334`	`$0.method = "post"`
`301`	`335`	`}`
`302`	`336`	`content:`
`@@ -307,7 +341,7 @@ extension Swiftinit.TagsPage:Swiftinit.ApplicationPage`
`307`	`341`	`{`
`308`	`342`	`$0.type = "hidden"`
`309`	`343`	`$0.name = "package"`
`310`		`- $0.value = "\(self.package.symbol)"`
	`344`	`+ $0.value = "\(self.package.id)"`
`311`	`345`	`}`
`312`	`346`
`313`	`347`	`$0[.input]`
`@@ -319,7 +353,7 @@ extension Swiftinit.TagsPage:Swiftinit.ApplicationPage`
`319`	`353`	`}`
`320`	`354`	`$0[.p]`
`321`	`355`	`{`
`322`		`- $0[.button] { $0.type = "submit" } = "Index GitHub Tag"`
	`356`	`+ $0[.button] { $0.type = "submit" } = "Index Package Tag (GitHub)"`
`323`	`357`	`}`
`324`	`358`	`}`
`325`	`359`	`}`
Original file line number	Diff line number	Diff line change
`@@ -9,7 +9,7 @@ import UnidocRecords`
`9`	`9`
`10`	`10`	`extension Swiftinit`
`11`	`11`	`{`
`12`		`- struct IndexRepoEndpoint:Sendable`
	`12`	`+ struct PackageIndexEndpoint:Sendable`
`13`	`13`	`{`
`14`	`14`	`let owner:String`
`15`	`15`	`let repo:String`
`@@ -21,7 +21,7 @@ extension Swiftinit`
`21`	`21`	`}`
`22`	`22`	`}`
`23`	`23`	`}`
`24`		`-extension Swiftinit.IndexRepoEndpoint:RestrictedEndpoint`
	`24`	`+extension Swiftinit.PackageIndexEndpoint:RestrictedEndpoint`
`25`	`25`	`{`
`26`	`26`	`func load(from server:borrowing Swiftinit.Server) async throws -> HTTP.ServerResponse?`
`27`	`27`	`{`
Original file line number	Diff line number	Diff line change
`@@ -9,19 +9,19 @@ import UnidocRecords`
`9`	`9`
`10`	`10`	`extension Swiftinit`
`11`	`11`	`{`
`12`		`- struct IndexRepoTagEndpoint:Sendable`
	`12`	`+ struct PackageIndexTagEndpoint:Sendable`
`13`	`13`	`{`
`14`		`- let package:Symbol.Package`
	`14`	`+ let package:Unidoc.Package`
`15`	`15`	`let tag:String`
`16`	`16`
`17`		`- init(package:Symbol.Package, tag:String)`
	`17`	`+ init(package:Unidoc.Package, tag:String)`
`18`	`18`	`{`
`19`	`19`	`self.package = package`
`20`	`20`	`self.tag = tag`
`21`	`21`	`}`
`22`	`22`	`}`
`23`	`23`	`}`
`24`		`-extension Swiftinit.IndexRepoTagEndpoint:RestrictedEndpoint`
	`24`	`+extension Swiftinit.PackageIndexTagEndpoint:RestrictedEndpoint`
`25`	`25`	`{`
`26`	`26`	`func load(from server:borrowing Swiftinit.Server) async throws -> HTTP.ServerResponse?`
`27`	`27`	`{`
`@@ -35,8 +35,7 @@ extension Swiftinit.IndexRepoTagEndpoint:RestrictedEndpoint`
`35`	`35`	`let session:Mongo.Session = try await .init(from: server.db.sessions)`
`36`	`36`
`37`	`37`	`guard`
`38`		`- let package:Unidoc.PackageMetadata = try await server.db.unidoc.package(`
`39`		`- named: self.package,`
	`38`	`+ let package:Unidoc.PackageMetadata = try await server.db.packages.find(id: self.package,`
`40`	`39`	`with: session)`
`41`	`40`	`else`
`42`	`41`	`{`
Original file line number	Diff line number	Diff line change
`@@ -46,6 +46,7 @@ extension Swiftinit.RobotsEndpoint:PublicEndpoint`
`46`	`46`	`User-agent: *`
`47`	`47`	`Disallow: /admin/`
`48`	`48`	`Disallow: /auth/`
	`49`	`+ Disallow: /reference/`
`49`	`50`
`50`	`51`	`""")`
`51`	`52`	`}`
Original file line number	Diff line number	Diff line change
`@@ -25,6 +25,6 @@ extension Swiftinit.GlobalUplinkEndpoint:NonblockingEndpoint`
`25`	`25`	`session:Mongo.Session,`
`26`	`26`	`status:Status) async`
`27`	`27`	`{`
`28`		`- try? await server.db.unidoc.rebuild(queue: self.queue, with: session)`
	`28`	`+ try? await server.db.unidoc.rebuildVolumes(queue: self.queue, with: session)`
`29`	`29`	`}`
`30`	`30`	`}`
Original file line number	Diff line number	Diff line change
`@@ -8,11 +8,11 @@ extension Swiftinit`
`8`	`8`	`{`
`9`	`9`	`struct PackageAlignEndpoint:Sendable`
`10`	`10`	`{`
`11`		`- let package:Symbol.Package`
	`11`	`+ let package:Unidoc.Package`
`12`	`12`	`let realm:String?`
`13`	`13`	`let force:Bool`
`14`	`14`
`15`		`- init(package:Symbol.Package,`
	`15`	`+ init(package:Unidoc.Package,`
`16`	`16`	`realm:String?,`
`17`	`17`	`force:Bool)`
`18`	`18`	`{`
`@@ -57,8 +57,7 @@ extension Swiftinit.PackageAlignEndpoint:NonblockingEndpoint`
`57`	`57`	`}`
`58`	`58`
`59`	`59`	`guard`
`60`		`- let package:Unidoc.PackageMetadata = try await server.db.unidoc.package(`
`61`		`- named: self.package,`
	`60`	`+ let package:Unidoc.PackageMetadata = try await server.db.packages.find(id: self.package,`
`62`	`61`	`with: session)`
`63`	`62`	`else`
`64`	`63`	`{`