storage

type AssetType string

type Extension struct {
	ID           string
	Location     string
	Dependencies []string
	Pack         []string
}

type Local struct {
	ExtDir string
	Logger slog.Logger
}

type PropertyType string

type Storage interface {
	// AddExtension adds the extension found at the specified source by copying it
	// into the extension storage directory and returns details about the added
	// extension.  The source may be an URI or a local file path.
	AddExtension(ctx context.Context, source string) (*Extension, error)
	// RemoveExtension removes the extension by id (publisher, name, and version)
	// or all versions if all is true (in which case the id should omit the
	// version) and returns the IDs removed.
	RemoveExtension(ctx context.Context, name string, all bool) ([]string, error)
	// FileServer provides a handler for fetching extension repository files from
	// a client.
	FileServer() http.Handler
	// Manifest returns the manifest for the provided extension version.
	Manifest(ctx context.Context, publisher, extension, version string) (*VSIXManifest, error)
	// WalkExtensions applies a function over every extension providing the
	// manifest for the latest version and a list of all available versions.  If
	// the function returns error the error is returned and the iteration aborted.
	WalkExtensions(ctx context.Context, fn func(manifest *VSIXManifest, versions []string) error) error
}

type VSIXAsset struct {
	Type        AssetType `xml:",attr"`
	Path        string    `xml:",attr"`
	Addressable string    `xml:",attr"`
}

type VSIXAssets struct {
	Asset []VSIXAsset
}

type VSIXIdentity struct {
	// ID correlates to ExtensionName, *not* ExtensionID.
	ID             string `xml:"Id,attr"`
	Version        string `xml:",attr"`
	Publisher      string `xml:",attr"`
	TargetPlatform string `xml:",attr"`
}

type VSIXManifest struct {
	Metadata     VSIXMetadata
	Installation struct {
		InstallationTarget struct {
			ID string `xml:"Id,attr"`
		}
	}
	Dependencies []string
	Assets       VSIXAssets
}

type VSIXMetadata struct {
	Description  string
	DisplayName  string
	Identity     VSIXIdentity
	Tags         string
	GalleryFlags string
	License      string
	Icon         string
	Properties   VSIXProperties
	Categories   string
}

type VSIXProperties struct {
	Property []VSIXProperty
}

type VSIXProperty struct {
	ID    PropertyType `xml:"Id,attr"`
	Value string       `xml:",attr"`
}