fix(*): handle the custom Destination in API docs and client generati…

…on (#413)

Co-authored-by: iawia002 <[email protected]>

rest/rest.go

@@ -234,6 +234,17 @@ func (r *Request) Meta(value *map[string]string) *Request {
 	return r
 }
 
+type topRPCResponse struct {
+	Result interface{} `json:"Result"`
+}
+
+// TOPRPCData sets TOP RPC style body result. The value must be a pointer.
+// For internal uses.
+func (r *Request) TOPRPCData(value interface{}) *Request {
+	r.data = &topRPCResponse{Result: value}
+	return r
+}
+
 // Data sets body result. value must be a pointer.
 func (r *Request) Data(value interface{}) *Request {
 	r.data = value

utils/generators/golang/helper.go

@@ -424,7 +424,7 @@ func (h *helper) Functions() ([]function, []string) {
 				fn.Parameters = append(fn.Parameters, p)
 			}
 			for _, result := range def.Results {
-				if result.Destination == definition.Error {
+				if strings.Contains(string(result.Destination), string(definition.Error)) {
 					// Ignore errors
 					continue
 				}

utils/generators/swagger/generator.go

@@ -583,10 +583,24 @@ func (g *Generator) enum(typ *api.Type) []spec.Parameter {
 	return results
 }
 
+func parseDestination(d definition.Destination) definition.Destination {
+	switch {
+	// for the custom Destination
+	case strings.Contains(string(d), string(definition.Meta)):
+		return definition.Meta
+	case strings.Contains(string(d), string(definition.Data)):
+		return definition.Data
+	case strings.Contains(string(d), string(definition.Error)):
+		return definition.Error
+	default:
+		return d
+	}
+}
+
 func (g *Generator) generateResponse(results []api.Result, examples []api.Example) *spec.Response {
 	response := &spec.Response{}
 	for _, result := range results {
-		switch g.destinationMapping[result.Destination] {
+		switch g.destinationMapping[parseDestination(result.Destination)] {
 		case "body":
 			response.Description = g.escapeNewline(result.Description)
 			schema := g.schemaForTypeName(result.Type)
@@ -609,6 +623,7 @@ func (g *Generator) generateResponse(results []api.Result, examples []api.Exampl
 	}
 	return response
 }
+
 func (g *Generator) escapeNewline(content string) string {
 	return strings.Replace(strings.TrimSpace(content), "\n", "<br/>", -1)
 }