feat: add ability to use fully qualified names for message names

converter/converter.go

@@ -186,3 +186,11 @@ func WithServices(serviceNames []protoreflect.FullName) Option {
 		return nil
 	}
 }
+
+// FullyQualifiedMessageNames decides if you want to use the full path in message names.
+func FullyQualifiedMessageNames(enabled bool) Option {
+	return func(g *generator) error {
+		g.options.FullyQualifiedMessageNames = enabled
+		return nil
+	}
+}

internal/converter/options/options.go

@@ -33,6 +33,9 @@ type Options struct {
 	TrimUnusedTypes bool
 	// WithProtoAnnotations will add some protobuf annotations for descriptions
 	WithProtoAnnotations bool
+	// FullyQualifiedMessageNames uses the full path for message types: {pkg}.{name} instead of just the name. This
+	// is helpful if you are mixing types from multiple services.
+	FullyQualifiedMessageNames bool
 	// Services filters which services will be used for generating OpenAPI spec.
 	Services []protoreflect.FullName
 
@@ -88,6 +91,8 @@ func FromString(s string) (Options, error) {
 			opts.WithProtoAnnotations = true
 		case param == "trim-unused-types":
 			opts.TrimUnusedTypes = true
+		case param == "fully-qualified-message-names":
+			opts.FullyQualifiedMessageNames = true
 		case strings.HasPrefix(param, "content-types="):
 			for _, contentType := range strings.Split(param[14:], ";") {
 				contentType = strings.TrimSpace(contentType)

internal/converter/schema/schema.go

@@ -22,8 +22,12 @@ func MessageToSchema(opts options.Options, tt protoreflect.MessageDescriptor) (s
 		}
 		return wk.ID, wk.Schema
 	}
+	title := string(tt.Name())
+	if opts.FullyQualifiedMessageNames {
+		title = string(tt.FullName())
+	}
 	s := &base.Schema{
-		Title:                string(tt.Name()),
+		Title:                title,
 		Description:          util.FormatComments(tt.ParentFile().SourceLocations().ByDescriptor(tt)),
 		Type:                 []string{"object"},
 		AdditionalProperties: &base.DynamicValue[*base.SchemaProxy, bool]{N: 1, B: false},