feat(decoder): ✨ add proto descriptor decoding tool

Added a new Go module "decoder" that reconstructs .proto files from a protobuf FileDescriptorSet binary. The tool outputs the recovered proto files to a specified directory. Updated solution structure to reference the new decoder module.

Author: caunt

EcoFlow.Mqtt.Api.slnx

@@ -6,4 +6,5 @@
     <Project Path="src/EcoFlow.Mqtt.Api/EcoFlow.Mqtt.Api.csproj" />
     <Project Path="src/EcoFlow.Proto.Exporter/EcoFlow.Proto.Exporter.csproj" />
   </Folder>
+  <Folder Name="/src/EcoFlow.Proto.Decoder/" />
 </Solution>

src/EcoFlow.Proto.Decoder/decoder.go

@@ -0,0 +1,60 @@
+package main
+
+import (
+	"os"
+	"path/filepath"
+
+	"google.golang.org/protobuf/proto"
+	"google.golang.org/protobuf/types/descriptorpb"
+
+	"github.com/jhump/protoreflect/desc"
+	"github.com/jhump/protoreflect/desc/protoprint"
+)
+
+func main() {
+	if len(os.Args) != 3 {
+		os.Stderr.WriteString("usage: decoder <file_descriptor_set.pb> <out_directory>\n")
+		os.Exit(2)
+	}
+
+	descriptorSetPath := os.Args[1]
+	outputDirectoryPath := os.Args[2]
+
+	descriptorSetBytes, readError := os.ReadFile(descriptorSetPath)
+	if readError != nil {
+		panic(readError)
+	}
+
+	var fileDescriptorSet descriptorpb.FileDescriptorSet
+	if unmarshalError := proto.Unmarshal(descriptorSetBytes, &fileDescriptorSet); unmarshalError != nil {
+		panic(unmarshalError)
+	}
+
+	fileDescriptors, buildError := desc.CreateFileDescriptorsFromSet(&fileDescriptorSet)
+	if buildError != nil {
+		panic(buildError)
+	}
+
+	protoPrinter := protoprint.Printer{}
+
+	for _, fileDescriptor := range fileDescriptors {
+		outputFilePath := filepath.Join(outputDirectoryPath, fileDescriptor.GetName())
+		if mkdirError := os.MkdirAll(filepath.Dir(outputFilePath), 0o755); mkdirError != nil {
+			panic(mkdirError)
+		}
+
+		outputFile, createError := os.Create(outputFilePath)
+		if createError != nil {
+			panic(createError)
+		}
+
+		printError := protoPrinter.PrintProtoFile(fileDescriptor, outputFile)
+		closeError := outputFile.Close()
+		if printError != nil {
+			panic(printError)
+		}
+		if closeError != nil {
+			panic(closeError)
+		}
+	}
+}

src/EcoFlow.Proto.Decoder/go.mod

@@ -0,0 +1,10 @@
+module decoder
+
+go 1.25.6
+
+require (
+	github.com/golang/protobuf v1.5.4 // indirect
+	github.com/jhump/protoreflect v1.18.0 // indirect
+	github.com/jhump/protoreflect/v2 v2.0.0-beta.1 // indirect
+	google.golang.org/protobuf v1.36.11 // indirect
+)

src/EcoFlow.Proto.Decoder/go.sum

@@ -0,0 +1,8 @@
+github.com/golang/protobuf v1.5.4 h1:i7eJL8qZTpSEXOPTxNKhASYpMn+8e5Q6AdndVa1dWek=
+github.com/golang/protobuf v1.5.4/go.mod h1:lnTiLA8Wa4RWRcIUkrtSVa5nRhsEGBg48fD6rSs7xps=
+github.com/jhump/protoreflect v1.18.0 h1:TOz0MSR/0JOZ5kECB/0ufGnC2jdsgZ123Rd/k4Z5/2w=
+github.com/jhump/protoreflect v1.18.0/go.mod h1:ezWcltJIVF4zYdIFM+D/sHV4Oh5LNU08ORzCGfwvTz8=
+github.com/jhump/protoreflect/v2 v2.0.0-beta.1 h1:Dw1rslK/VotaUGYsv53XVWITr+5RCPXfvvlGrM/+B6w=
+github.com/jhump/protoreflect/v2 v2.0.0-beta.1/go.mod h1:D9LBEowZyv8/iSu97FU2zmXG3JxVTmNw21mu63niFzU=
+google.golang.org/protobuf v1.36.11 h1:fV6ZwhNocDyBLK0dj+fg8ektcVegBBuEolpbTQyBNVE=
+google.golang.org/protobuf v1.36.11/go.mod h1:HTf+CrKn2C3g5S8VImy6tdcUvCska2kB7j23XfzDpco=