webFramework

type FakeParser struct {
	Method      string
	Path        string
	Header      HeaderInterface
	HttpHeader  http.Header
	ReqHeader   map[string]string
	RespHeader  map[string]string
	Body        any
	URI         any
	URLQuery    any
	RawUrlQuery string
	Locals      map[string]any
	Args        map[string]string
	Urlparams   map[string]string
	JsonResp    any
}

type FieldParser interface {
	Parse(string) string
}

type HeaderInterface interface {
	GetID() string
	GetUser() string
	GetProgram() string
	GetModule() string
	GetMethod() string
	SetUser(string)
	SetProgram(string)
	SetModule(string)
	SetMethod(string)
}

type RecordData interface {
	GetID() string
	GetControlID(string) string
	GetIDList() []any
	SetID(string)
	SetValue(string)
	GetSubCategory() string
	GetValue() any
	GetValueMap() map[string]string
}

type RequestHandler interface {
	Respond(code, status int, message string, data any, abort bool)
	HandleErrorState(err error, status int, message string, data any)
}

type RequestParser interface {
	GetMethod() string
	GetPath() string
	GetHeader(target HeaderInterface) error
	GetHeaderValue(name string) string
	GetHTTPHeader() http.Header
	GetBody(target any) error
	GetURI(target any) error
	GetURLQuery(target any) error
	GetRawURLQuery() string
	GetLocal(name string) any
	GetLocalString(name string) string
	GetURLParam(name string) string
	GetURLParams() map[string]string
	CheckURLParam(name string) (string, bool)
	SetLocal(name string, value any)
	SetReqHeader(name string, value string)
	SetRespHeader(name string, value string)
	GetArgs(args ...any) map[string]string
	ParseCommand(command, title string, request RecordData, parser FieldParser) string
	SendJSONRespBody(status int, resp any) error
	Next() error
	Abort() error
	FormValue(name string) string
	SaveFile(formTagName, path string) error
	FileAttachment(path, fileName string)
	AddCustomAttributes(attr slog.Attr)
	// Tracing methods
	GetTraceContext() trace.SpanContext
	SetTraceContext(spanCtx trace.SpanContext)
	StartSpan(name string, opts ...trace.SpanStartOption) (context.Context, trace.Span)
	AddSpanAttribute(key, value string)
	AddSpanAttributes(attrs map[string]string)
	AddSpanEvent(name string, attrs map[string]string)
	RecordSpanError(err error, attrs map[string]string)
	// Context management for tracing
	GetContext() context.Context
	SetContext(context.Context)
}

type TransactionInfo struct {
	ServiceName        string        // param.API.Name
	URL                string        // full request URL (domain + "/" + path + query)
	Endpoint           string        // param.Path
	Method             string        // param.Method (HTTP method)
	StatusCode         int           // actual HTTP status (0 if request failed before getting a response)
	Duration           time.Duration // elapsed time
	Error              error         // nil on success
	Request            any           // param.JSONBody (caller may mask sensitive fields via CallAPIOptions.MaskFunc)
	Response           any           // parsed response (nil on error; caller may mask via MaskFunc)
	ResponseBody       []byte        // raw response body from RemoteCallError on error, nil on success; preserved raw for diagnostics — may contain sensitive data
	MaskedResponseBody any           // MaskFunc(ResponseBody) on error paths when CallAPIOptions.MaskFunc is set; nil when MaskFunc is nil or on success. Transaction loggers should emit this field by default and use ResponseBody only when the raw bytes are explicitly required.
}

type TransactionLogger interface {
	LogTransaction(info TransactionInfo)
}

type WebFramework struct {
	Ctx  context.Context
	Span trace.Span
	//Handler response.ResponseHandler
	Parser RequestParser
}