Private Registry Steward

Build a Go module that lists and repairs an organization's private package registry for a single package type (for example, container or npm).

Capabilities

List private packages

• With owner and package type set, it returns only private packages and sorts their names alphabetically. @test
• When the registry has no private packages, it returns an empty slice without error. @test

Inspect package versions

• For a given package, it fetches versions ordered by most recently updated first, including version IDs and update timestamps. @test
• When IncludeDeleted is true, deleted versions are included and marked in the result. @test

Retire a version

• Removing a specified package version succeeds silently and excludes it from later version listings. @test

Restore a deleted version

• A previously deleted version can be restored so it appears again in subsequent listings. @test

Implementation

@generates

API

package registry

import "context"
import "time"

type PackageVersionInfo struct {
    ID        int64
    Name      string
    UpdatedAt time.Time
    Deleted   bool
}

type Manager struct {
    Owner          string
    PackageType    string
    IncludeDeleted bool
}

func NewManager(owner string, packageType string, includeDeleted bool) *Manager
func (m *Manager) ListPrivatePackages(ctx context.Context) ([]string, error)
func (m *Manager) ListPackageVersions(ctx context.Context, packageName string) ([]PackageVersionInfo, error)
func (m *Manager) RetireVersion(ctx context.Context, packageName string, versionID int64) error
func (m *Manager) RestoreVersion(ctx context.Context, packageName string, versionID int64) error

Dependencies { .dependencies }

github.com/google/go-github/v80/github { .dependency }

Typed client for the GitHub REST API, used for interacting with private package registries and their versions.