The generated well known Golang code now includes a link to the used …

…package on the registry

protoregistry/generator/generator.go

@@ -75,7 +75,12 @@ func main() {
 			if file.Name != nil {
 				name = *file.Name
 			}
-			protofiles = append(protofiles, ProtoFile{name, cnt})
+
+			protofiles = append(protofiles, ProtoFile{
+				Name:                  name,
+				Data:                  cnt,
+				BufRegistryPackageURL: buildBufRegistryPackageURL(wellKnownProtoRepo, deferPtr(file.Package, ""), fileDescriptorSet.Msg.Version),
+			})
 		}
 		// avoid hitting the buf.build rate limit
 		time.Sleep(1 * time.Second)
@@ -109,9 +114,15 @@ func main() {
 	fmt.Println("Done creating well known registry")
 }
 
+func buildBufRegistryPackageURL(module string, fullyQualifiedPackage string, revision string) string {
+	// Example full URL is https://buf.build/streamingfast/firehose-near/docs/146e2ae8bd9b49e29b132b8627f29a70:sf.near.type.v1
+	return fmt.Sprintf("https://%s/docs/%s:%s", module, revision, fullyQualifiedPackage)
+}
+
 type ProtoFile struct {
-	Name string
-	Data []byte
+	Name                  string
+	Data                  []byte
+	BufRegistryPackageURL string
 }
 
 func templateFunctions() template.FuncMap {
@@ -124,3 +135,11 @@ func templateFunctions() template.FuncMap {
 		},
 	}
 }
+
+func deferPtr[T any](in *T, orValue T) T {
+	if in == nil {
+		return orValue
+	}
+
+	return *in
+}

protoregistry/generator/template.gotmpl

@@ -1,4 +1,4 @@
-// Code generated by generate_flags, DO NOT EDIT!
+// Code generated by 'go run github.com/streamingfast/firehose-core/protoregistry/generator well_known.go protoregistry', DO NOT EDIT!
 package {{.Package}}
 
 import (
@@ -15,10 +15,11 @@ var WellKnownRegistry = New()
 
 func init() {
 	protoFiles := []string{
-	 {{range .ProtoFiles}}
-  	   // {{.Name}}
-   		"{{.Data | toHex}}",
-   {{end}}
+		{{- range .ProtoFiles}}
+
+		// {{.Name}} ({{.BufRegistryPackageURL}})
+		"{{.Data | toHex}}",
+   		{{- end}}
 	}
 
 	var files []*descriptorpb.FileDescriptorProto