409 lines
		
	
	
		
			11 KiB
		
	
	
	
		
			Go
		
	
	
	
			
		
		
	
	
			409 lines
		
	
	
		
			11 KiB
		
	
	
	
		
			Go
		
	
	
	
/*
 | 
						|
 * Copyright 2025 coze-dev Authors
 | 
						|
 *
 | 
						|
 * Licensed under the Apache License, Version 2.0 (the "License");
 | 
						|
 * you may not use this file except in compliance with the License.
 | 
						|
 * You may obtain a copy of the License at
 | 
						|
 *
 | 
						|
 *     http://www.apache.org/licenses/LICENSE-2.0
 | 
						|
 *
 | 
						|
 * Unless required by applicable law or agreed to in writing, software
 | 
						|
 * distributed under the License is distributed on an "AS IS" BASIS,
 | 
						|
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 | 
						|
 * See the License for the specific language governing permissions and
 | 
						|
 * limitations under the License.
 | 
						|
 */
 | 
						|
 | 
						|
package nodes
 | 
						|
 | 
						|
import (
 | 
						|
	"context"
 | 
						|
	"errors"
 | 
						|
	"fmt"
 | 
						|
	"strconv"
 | 
						|
	"strings"
 | 
						|
 | 
						|
	"github.com/coze-dev/coze-studio/backend/domain/workflow/entity/vo"
 | 
						|
	"github.com/coze-dev/coze-studio/backend/pkg/errorx"
 | 
						|
	"github.com/coze-dev/coze-studio/backend/pkg/lang/ptr"
 | 
						|
	"github.com/coze-dev/coze-studio/backend/pkg/logs"
 | 
						|
	"github.com/coze-dev/coze-studio/backend/pkg/sonic"
 | 
						|
	"github.com/coze-dev/coze-studio/backend/types/errno"
 | 
						|
)
 | 
						|
 | 
						|
type ConversionWarning struct {
 | 
						|
	Path string
 | 
						|
	Type vo.DataType
 | 
						|
	Err  error
 | 
						|
}
 | 
						|
 | 
						|
func (e *ConversionWarning) Error() string {
 | 
						|
	return fmt.Sprintf("field %s is not %s", e.Path, e.Type)
 | 
						|
}
 | 
						|
 | 
						|
type ConversionWarnings []*ConversionWarning
 | 
						|
 | 
						|
func (e ConversionWarnings) Merge(e1 ConversionWarnings) ConversionWarnings {
 | 
						|
	return append(e, e1...)
 | 
						|
}
 | 
						|
 | 
						|
func (e ConversionWarnings) Error() string {
 | 
						|
	if len(e) == 0 {
 | 
						|
		return ""
 | 
						|
	}
 | 
						|
	var errs []string
 | 
						|
	for _, err := range e {
 | 
						|
		errs = append(errs, err.Error())
 | 
						|
	}
 | 
						|
	return strings.Join(errs, ", ")
 | 
						|
}
 | 
						|
 | 
						|
func newWarnings(path string, t vo.DataType, err error) *ConversionWarnings {
 | 
						|
	return ptr.Of(ConversionWarnings{
 | 
						|
		{
 | 
						|
			Path: path,
 | 
						|
			Type: t,
 | 
						|
			Err:  err,
 | 
						|
		},
 | 
						|
	})
 | 
						|
}
 | 
						|
 | 
						|
func ConvertInputs(ctx context.Context, in map[string]any, tInfo map[string]*vo.TypeInfo, opts ...ConvertOption) (
 | 
						|
	map[string]any, *ConversionWarnings, error) {
 | 
						|
	options := &convertOptions{}
 | 
						|
	for _, opt := range opts {
 | 
						|
		opt(options)
 | 
						|
	}
 | 
						|
 | 
						|
	if len(in) == 0 {
 | 
						|
		if !options.skipRequireCheck {
 | 
						|
			for n, t := range tInfo {
 | 
						|
				if t.Required {
 | 
						|
					return nil, nil, vo.NewError(errno.ErrMissingRequiredParam, errorx.KV("param", n))
 | 
						|
				}
 | 
						|
			}
 | 
						|
		}
 | 
						|
		return in, nil, nil
 | 
						|
	}
 | 
						|
 | 
						|
	out := make(map[string]any)
 | 
						|
	var warnings ConversionWarnings
 | 
						|
	for k, v := range in {
 | 
						|
		t, ok := tInfo[k]
 | 
						|
		if !ok {
 | 
						|
			// for input fields not explicitly defined, just pass the string value through
 | 
						|
			logs.CtxWarnf(ctx, "input %s not found in type info", k)
 | 
						|
			if !options.skipUnknownFields {
 | 
						|
				out[k] = in[k]
 | 
						|
			}
 | 
						|
			continue
 | 
						|
		}
 | 
						|
 | 
						|
		converted, ws, err := Convert(ctx, v, k, t, opts...)
 | 
						|
		if err != nil {
 | 
						|
			return nil, nil, vo.WrapError(errno.ErrInvalidParameter, err)
 | 
						|
		}
 | 
						|
 | 
						|
		if ws != nil {
 | 
						|
			warnings = append(warnings, *ws...)
 | 
						|
		}
 | 
						|
		out[k] = converted
 | 
						|
	}
 | 
						|
 | 
						|
	if !options.skipRequireCheck {
 | 
						|
		for k, t := range tInfo {
 | 
						|
			if _, ok := out[k]; !ok {
 | 
						|
				if t.Required {
 | 
						|
					return nil, nil, vo.NewError(errno.ErrMissingRequiredParam, errorx.KV("param", k))
 | 
						|
				}
 | 
						|
			}
 | 
						|
		}
 | 
						|
	}
 | 
						|
 | 
						|
	if len(warnings) > 0 {
 | 
						|
		return out, &warnings, nil
 | 
						|
	}
 | 
						|
 | 
						|
	return out, nil, nil
 | 
						|
}
 | 
						|
 | 
						|
type convertOptions struct {
 | 
						|
	skipUnknownFields bool
 | 
						|
	failFast          bool
 | 
						|
	skipRequireCheck  bool
 | 
						|
}
 | 
						|
 | 
						|
type ConvertOption func(*convertOptions)
 | 
						|
 | 
						|
func SkipUnknownFields() ConvertOption {
 | 
						|
	return func(o *convertOptions) {
 | 
						|
		o.skipUnknownFields = true
 | 
						|
	}
 | 
						|
}
 | 
						|
 | 
						|
func FailFast() ConvertOption {
 | 
						|
	return func(o *convertOptions) {
 | 
						|
		o.failFast = true
 | 
						|
	}
 | 
						|
}
 | 
						|
 | 
						|
func SkipRequireCheck() ConvertOption {
 | 
						|
	return func(o *convertOptions) {
 | 
						|
		o.skipRequireCheck = true
 | 
						|
	}
 | 
						|
}
 | 
						|
 | 
						|
func Convert(ctx context.Context, in any, path string, t *vo.TypeInfo, opts ...ConvertOption) (
 | 
						|
	any, *ConversionWarnings, error) {
 | 
						|
	options := &convertOptions{}
 | 
						|
	for _, opt := range opts {
 | 
						|
		opt(options)
 | 
						|
	}
 | 
						|
	return convert(ctx, in, path, t, options)
 | 
						|
}
 | 
						|
 | 
						|
func convert(ctx context.Context, in any, path string, t *vo.TypeInfo, options *convertOptions) (
 | 
						|
	any, *ConversionWarnings, error) {
 | 
						|
	if in == nil { // nil is valid for ALL types
 | 
						|
		return nil, nil, nil
 | 
						|
	}
 | 
						|
 | 
						|
	switch t.Type {
 | 
						|
	case vo.DataTypeString, vo.DataTypeFile, vo.DataTypeTime:
 | 
						|
		return convertToString(ctx, in, path, options)
 | 
						|
	case vo.DataTypeInteger:
 | 
						|
		return convertToInt64(ctx, in, path, options)
 | 
						|
	case vo.DataTypeNumber:
 | 
						|
		return convertToFloat64(ctx, in, path, options)
 | 
						|
	case vo.DataTypeBoolean:
 | 
						|
		return convertToBool(ctx, in, path, options)
 | 
						|
	case vo.DataTypeObject:
 | 
						|
		return convertToObject(ctx, in, path, t, options)
 | 
						|
	case vo.DataTypeArray:
 | 
						|
		return convertToArray(ctx, in, path, t, options)
 | 
						|
	default:
 | 
						|
		if options.failFast {
 | 
						|
			return nil, nil, vo.WrapError(errno.ErrInvalidParameter, fmt.Errorf("unknown input type %s for path %s", t.Type, path))
 | 
						|
		}
 | 
						|
		logs.CtxErrorf(ctx, "unknown input type %s for path %s", t.Type, path)
 | 
						|
		return in, newWarnings(path, t.Type, errors.New("unknown input type")), nil
 | 
						|
	}
 | 
						|
}
 | 
						|
 | 
						|
func convertToString(_ context.Context, in any, path string, options *convertOptions) (any, *ConversionWarnings, error) {
 | 
						|
	switch in.(type) {
 | 
						|
	case string:
 | 
						|
		return in.(string), nil, nil
 | 
						|
	case int64:
 | 
						|
		return strconv.FormatInt(in.(int64), 10), nil, nil
 | 
						|
	case float64:
 | 
						|
		return strconv.FormatFloat(in.(float64), 'f', -1, 64), nil, nil
 | 
						|
	case bool:
 | 
						|
		return strconv.FormatBool(in.(bool)), nil, nil
 | 
						|
	case []any, map[string]any:
 | 
						|
		s, err := sonic.MarshalString(in)
 | 
						|
		if err != nil {
 | 
						|
			if options.failFast {
 | 
						|
				return nil, nil, vo.WrapError(errno.ErrSerializationDeserializationFail, err)
 | 
						|
			}
 | 
						|
			return nil, newWarnings(path, vo.DataTypeString, err), nil
 | 
						|
		}
 | 
						|
		return s, nil, nil
 | 
						|
	default:
 | 
						|
		if options.failFast {
 | 
						|
			return nil, nil, vo.WrapError(errno.ErrInvalidParameter, fmt.Errorf("unsupported type to convert to string: %T", in))
 | 
						|
		}
 | 
						|
		return nil, newWarnings(path, vo.DataTypeString, fmt.Errorf("unsupported type to convert to string: %T", in)), nil
 | 
						|
	}
 | 
						|
}
 | 
						|
 | 
						|
func convertToInt64(_ context.Context, in any, path string, options *convertOptions) (any, *ConversionWarnings, error) {
 | 
						|
	switch in.(type) {
 | 
						|
	case int64:
 | 
						|
		return in.(int64), nil, nil
 | 
						|
	case float64:
 | 
						|
		return int64(in.(float64)), nil, nil
 | 
						|
	case string:
 | 
						|
		i, err := strconv.ParseInt(in.(string), 10, 64)
 | 
						|
		if err != nil {
 | 
						|
			if options.failFast {
 | 
						|
				return nil, nil, vo.WrapError(errno.ErrInvalidParameter, err)
 | 
						|
			}
 | 
						|
			return nil, newWarnings(path, vo.DataTypeInteger, err), nil
 | 
						|
		}
 | 
						|
		return i, nil, nil
 | 
						|
	default:
 | 
						|
		if options.failFast {
 | 
						|
			return nil, nil, vo.WrapError(errno.ErrInvalidParameter, fmt.Errorf("unsupported type to convert to int64: %T", in))
 | 
						|
		}
 | 
						|
		return nil, newWarnings(path, vo.DataTypeInteger, fmt.Errorf("unsupported type to convert to int64: %T", in)), nil
 | 
						|
	}
 | 
						|
}
 | 
						|
 | 
						|
func convertToFloat64(_ context.Context, in any, path string, options *convertOptions) (any, *ConversionWarnings, error) {
 | 
						|
	switch in.(type) {
 | 
						|
	case int64:
 | 
						|
		return float64(in.(int64)), nil, nil
 | 
						|
	case float64:
 | 
						|
		return in.(float64), nil, nil
 | 
						|
	case string:
 | 
						|
		f, err := strconv.ParseFloat(in.(string), 64)
 | 
						|
		if err != nil {
 | 
						|
			if options.failFast {
 | 
						|
				return nil, nil, vo.WrapError(errno.ErrInvalidParameter, err)
 | 
						|
			}
 | 
						|
			return nil, newWarnings(path, vo.DataTypeNumber, err), nil
 | 
						|
		}
 | 
						|
		return f, nil, nil
 | 
						|
	default:
 | 
						|
		if options.failFast {
 | 
						|
			return nil, nil, vo.WrapError(errno.ErrInvalidParameter, fmt.Errorf("unsupported type to convert to float64: %T", in))
 | 
						|
		}
 | 
						|
		return nil, newWarnings(path, vo.DataTypeNumber, fmt.Errorf("unsupported type to convert to float64: %T", in)), nil
 | 
						|
	}
 | 
						|
}
 | 
						|
 | 
						|
func convertToBool(_ context.Context, in any, path string, options *convertOptions) (any, *ConversionWarnings, error) {
 | 
						|
	switch in.(type) {
 | 
						|
	case bool:
 | 
						|
		return in.(bool), nil, nil
 | 
						|
	case string:
 | 
						|
		b, err := strconv.ParseBool(in.(string))
 | 
						|
		if err != nil {
 | 
						|
			if options.failFast {
 | 
						|
				return nil, nil, vo.WrapError(errno.ErrInvalidParameter, err)
 | 
						|
			}
 | 
						|
			return nil, newWarnings(path, vo.DataTypeBoolean, err), nil
 | 
						|
		}
 | 
						|
		return b, nil, nil
 | 
						|
	default:
 | 
						|
		if options.failFast {
 | 
						|
			return nil, nil, vo.WrapError(errno.ErrInvalidParameter, fmt.Errorf("unsupported type to convert to bool: %T", in))
 | 
						|
		}
 | 
						|
		return nil, newWarnings(path, vo.DataTypeBoolean, fmt.Errorf("unsupported type to convert to bool: %T", in)), nil
 | 
						|
	}
 | 
						|
}
 | 
						|
 | 
						|
func convertToObject(ctx context.Context, in any, path string, t *vo.TypeInfo, options *convertOptions) (
 | 
						|
	map[string]any, *ConversionWarnings, error) {
 | 
						|
	var m map[string]any
 | 
						|
	switch in.(type) {
 | 
						|
	case map[string]any:
 | 
						|
		m = in.(map[string]any)
 | 
						|
	case string:
 | 
						|
		err := sonic.UnmarshalString(in.(string), &m)
 | 
						|
		if err != nil {
 | 
						|
			if options.failFast {
 | 
						|
				return nil, nil, vo.WrapError(errno.ErrSerializationDeserializationFail, err)
 | 
						|
			}
 | 
						|
			return nil, newWarnings(path, vo.DataTypeObject, err), nil
 | 
						|
		}
 | 
						|
	default:
 | 
						|
		if options.failFast {
 | 
						|
			return nil, nil, vo.WrapError(errno.ErrInvalidParameter, fmt.Errorf("unsupported type to convert to object: %T", in))
 | 
						|
		}
 | 
						|
		return nil, newWarnings(path, vo.DataTypeObject, fmt.Errorf("unsupported type to convert to object: %T", in)), nil
 | 
						|
	}
 | 
						|
 | 
						|
	if len(m) == 0 {
 | 
						|
		if !options.skipRequireCheck {
 | 
						|
			for pn, pro := range t.Properties {
 | 
						|
				if pro.Required {
 | 
						|
					return nil, nil, vo.NewError(errno.ErrMissingRequiredParam,
 | 
						|
						errorx.KV("param", fmt.Sprintf("%s.%s", path, pn)))
 | 
						|
				}
 | 
						|
			}
 | 
						|
		}
 | 
						|
		return m, nil, nil
 | 
						|
	}
 | 
						|
 | 
						|
	out := make(map[string]any, len(m))
 | 
						|
	var warnings ConversionWarnings
 | 
						|
	for k, v := range m {
 | 
						|
		propType, ok := t.Properties[k]
 | 
						|
		if !ok {
 | 
						|
			// for input fields not explicitly defined, just pass the value through
 | 
						|
			logs.CtxWarnf(ctx, "input %s.%s not found in type info", path, k)
 | 
						|
			if !options.skipUnknownFields {
 | 
						|
				out[k] = v
 | 
						|
			}
 | 
						|
			continue
 | 
						|
		}
 | 
						|
 | 
						|
		propPath := fmt.Sprintf("%s.%s", path, k)
 | 
						|
		newV, ws, err := convert(ctx, v, propPath, propType, options)
 | 
						|
		if err != nil {
 | 
						|
			return nil, nil, err
 | 
						|
		} else if ws != nil {
 | 
						|
			warnings = append(warnings, *ws...)
 | 
						|
		}
 | 
						|
		out[k] = newV
 | 
						|
	}
 | 
						|
 | 
						|
	if !options.skipRequireCheck {
 | 
						|
		for k, t := range t.Properties {
 | 
						|
			if _, ok := out[k]; !ok {
 | 
						|
				if t.Required {
 | 
						|
					return nil, nil, vo.NewError(errno.ErrMissingRequiredParam,
 | 
						|
						errorx.KV("param", fmt.Sprintf("%s.%s", path, k)))
 | 
						|
				}
 | 
						|
			}
 | 
						|
		}
 | 
						|
	}
 | 
						|
 | 
						|
	if len(warnings) > 0 {
 | 
						|
		return out, ptr.Of(warnings), nil
 | 
						|
	}
 | 
						|
	return out, nil, nil
 | 
						|
}
 | 
						|
 | 
						|
func convertToArray(ctx context.Context, in any, path string, t *vo.TypeInfo, options *convertOptions) (
 | 
						|
	[]any, *ConversionWarnings, error) {
 | 
						|
	var a []any
 | 
						|
	switch v := in.(type) {
 | 
						|
	case []any:
 | 
						|
		a = v
 | 
						|
	case string:
 | 
						|
		err := sonic.UnmarshalString(v, &a)
 | 
						|
		if err != nil {
 | 
						|
			if options.failFast {
 | 
						|
				return nil, nil, vo.WrapError(errno.ErrSerializationDeserializationFail, err)
 | 
						|
			}
 | 
						|
			return []any{}, newWarnings(path, vo.DataTypeArray, err), nil
 | 
						|
		}
 | 
						|
	default:
 | 
						|
		if options.failFast {
 | 
						|
			return nil, nil, vo.WrapError(errno.ErrInvalidParameter, fmt.Errorf("unsupported type to convert to array: %T", in))
 | 
						|
		}
 | 
						|
		return []any{}, newWarnings(path, vo.DataTypeArray, fmt.Errorf("unsupported type to convert to array: %T", in)), nil
 | 
						|
	}
 | 
						|
 | 
						|
	if len(a) == 0 {
 | 
						|
		return a, nil, nil
 | 
						|
	}
 | 
						|
 | 
						|
	out := make([]any, 0, len(a))
 | 
						|
	var warnings ConversionWarnings
 | 
						|
	elemType := t.ElemTypeInfo
 | 
						|
	for i, v := range a {
 | 
						|
		elemPath := fmt.Sprintf("%s.%d", path, i)
 | 
						|
		newV, ws, err := convert(ctx, v, elemPath, elemType, options)
 | 
						|
		if err != nil {
 | 
						|
			return nil, nil, err
 | 
						|
		} else if ws != nil {
 | 
						|
			if elemType.Type == vo.DataTypeObject { // If the array type and the element is an object, the converted object will also need to be added to the array when waring occurs
 | 
						|
				out = append(out, newV)
 | 
						|
			}
 | 
						|
			warnings = append(warnings, *ws...)
 | 
						|
		} else { // only correctly converted elements go into the final array
 | 
						|
			out = append(out, newV)
 | 
						|
		}
 | 
						|
	}
 | 
						|
 | 
						|
	if len(warnings) > 0 {
 | 
						|
		return out, ptr.Of(warnings), nil
 | 
						|
	}
 | 
						|
 | 
						|
	return out, nil, nil
 | 
						|
}
 |