feat(yae): add optional schema field

flake.nix

···
               inherit meta;
 
               pname = name;
-              version = "2024.10.14";
+              version = "2024.10.25";
               src = pkgs.lib.cleanSource ./.;
               vendorHash = "sha256-XQEB2vgiztbtLnc7BR4WTouPI+2NDQXXFUNidqmvbac=";
               buildInputs = [ pkgs.musl ];

internal/commands/add.go

···
 	}
 }
 
-func Add(sources *yae.Sources) func(c *cli.Context) error {
+func Add(sources *yae.Environment) func(c *cli.Context) error {
 	return func(c *cli.Context) error {
 		if c.Args().Len() != 2 {
 			return fmt.Errorf("invalid number of arguments")

internal/commands/drop.go

···
 	"github.com/urfave/cli/v2"
 )
 
-func Drop(sources *yae.Sources) func(c *cli.Context) error {
+func Drop(sources *yae.Environment) func(c *cli.Context) error {
 	return func(c *cli.Context) error {
 		if c.Args().Len() == 0 {
 			return fmt.Errorf("invalid number of arguments")

internal/commands/init.go

···
 	"github.com/urfave/cli/v2"
 )
 
-func Init(sources *yae.Sources) func(c *cli.Context) error {
+func Init(sources *yae.Environment) func(c *cli.Context) error {
 	return func(c *cli.Context) error {
 		if _, err := os.Stat(c.String("sources")); err == nil {
 			return fmt.Errorf("sources file already exists")

internal/commands/update.go

···
 	}
 }
 
-func Update(sources *yae.Sources) func(c *cli.Context) error {
+func Update(sources *yae.Environment) func(c *cli.Context) error {
 	return func(c *cli.Context) error {
 		updates := []string{}
 		force := c.Bool("force-hashed")
 		forcePinned := c.Bool("force-pinned")
 
 		if c.Args().Len() == 0 {
-			for name, source := range *sources {
+			for name, source := range sources.Sources {
 				if updated, err := source.Update(sources, name, force, forcePinned); err != nil {
 					return err
 				} else if updated {
···
 			}
 		} else {
 			name := c.Args().Get(0)
-			source := (*sources)[name]
+			source := (*sources).Sources[name]
 
 			if updated, err := source.Update(sources, name, force, forcePinned); err != nil {
 				return err

internal/yae/environment.go

···
+package yae
+
+import (
+	"encoding/json"
+	"fmt"
+	"os"
+)
+
+type Environment struct {
+	Schema  string
+	Sources map[string]Source
+}
+
+func (s *Environment) Add(name string, d Source) error {
+	if s.Exists(name) {
+		return fmt.Errorf("source already exists")
+	}
+
+	(*s).Sources[name] = d
+
+	return nil
+}
+
+func (s *Environment) Exists(name string) bool {
+	_, ok := (*s).Sources[name]
+
+	return ok
+}
+
+func (s *Environment) Drop(url string) {
+	delete((*s).Sources, url)
+}
+
+func (s *Environment) Save(path string) error {
+	file, err := os.Create(path)
+
+	if err != nil {
+		return err
+	}
+
+	defer file.Close()
+
+	sourcesData, err := json.Marshal(s.Sources)
+
+	if err != nil {
+		return err
+	}
+
+	var jsonData map[string]json.RawMessage
+
+	if err := json.Unmarshal(sourcesData, &jsonData); err != nil {
+		return err
+	}
+
+	if s.Schema != "" {
+		jsonData["$schema"] = json.RawMessage(fmt.Sprintf(`"%s"`, s.Schema))
+	}
+
+	encoder := json.NewEncoder(file)
+
+	encoder.SetIndent("", "  ")
+
+	return encoder.Encode(jsonData)
+}
+
+func (s *Environment) Load(path string) error {
+	file, err := os.Open(path)
+
+	if err != nil {
+		return err
+	}
+
+	defer file.Close()
+
+	var rawData map[string]json.RawMessage
+
+	if err := json.NewDecoder(file).Decode(&rawData); err != nil {
+		return err
+	}
+
+	if schema, ok := rawData["$schema"]; ok {
+		json.Unmarshal(schema, &s.Schema)
+	}
+
+	delete(rawData, "$schema")
+
+	if filteredData, err := json.Marshal(rawData); err != nil {
+		return err
+	} else {
+		return json.Unmarshal(filteredData, &s.Sources)
+	}
+}

internal/yae/source.go

···
 	Force         bool   `json:"force,omitempty"`
 }
 
-func (source *Source) Update(sources *Sources, name string, force bool, forcePinned bool) (bool, error) {
+func (source *Source) Update(sources *Environment, name string, force bool, forcePinned bool) (bool, error) {
 	log.Infof("checking %s", name)
 
 	updated := false
···
 		updated = true
 	}
 
-	(*sources)[name] = *source
+	(*sources).Sources[name] = *source
 
 	return updated, nil
 }

internal/yae/sources.go

···
-package yae
-
-import (
-	"encoding/json"
-	"fmt"
-	"os"
-)
-
-type Sources map[string]Source
-
-func (s *Sources) Add(name string, d Source) error {
-	if s.Exists(name) {
-		return fmt.Errorf("source already exists")
-	}
-
-	(*s)[name] = d
-
-	return nil
-}
-
-func (s *Sources) Exists(name string) bool {
-	_, ok := (*s)[name]
-
-	return ok
-}
-
-func (s *Sources) Drop(url string) {
-	delete((*s), url)
-}
-
-func (s *Sources) Save(path string) error {
-	file, err := os.Create(path)
-
-	if err != nil {
-		return err
-	}
-
-	encoder := json.NewEncoder(file)
-
-	encoder.SetIndent("", "  ")
-
-	return encoder.Encode(s)
-}
-
-func (s *Sources) Load(path string) error {
-	file, err := os.Open(path)
-
-	if err != nil {
-		return err
-	}
-
-	return json.NewDecoder(file).Decode(s)
-}

yae.go

···
 )
 
 func main() {
-	sources := yae.Sources{}
+	sources := yae.Environment{}
 
 	if err := (&cli.App{
 		Name:                 "yae",