executor

type BaseExecutor[R any] struct {
	DB         *sqlx.DB
	SQL        string
	OpType     config.OpType
	Entity     config.EntityType
	Transforms *CompiledTransforms
	MockSource mock.Source
	Builder    ResultBuilder[R]
}

type CompileTransformOptions struct {
	ConfigDir   string
	Helpers     *js.CompiledHelpers
	ValueParser *mock.ValueParser
}

type CompiledTransforms struct {
	Pre      *js.Transformer
	PostEach *js.Transformer
	PostAll  *js.Transformer
}

type DBExecutor[R any] interface {
	ExecuteDB(reqCtx context.Context, ec *ExecContext[R]) (*R, error)
}

type ExecContext[R any] struct {
	Base           *BaseExecutor[R]
	Ctx            map[string]any
	SQL            string
	Params         map[string]any
	OriginalParams map[string]any
	Opts           Options
	TC             *js.TransformContext
}

type ExecuteResult struct {
	Output         any         // The response data
	Status         int         // HTTP status code (0 means default)
	ResponseHeader http.Header // Response headers to set
}

type MutationExecutor struct {
	// contains filtered or unexported fields
}

type MutationResult struct {
	Data           any
	NoContent      bool
	Status         int
	ResponseHeader http.Header
}

type Options struct {
	Recorder    Recorder
	HTTPRequest *http.Request // HTTP request for transform context
}

type PhaseError struct {
	Phase string // "pre", "mock", or "post"
	Err   error
}

type QueryExecutor struct {
	// contains filtered or unexported fields
}

type Record struct {
	Type   config.OpType  // OpTypeOne, OpTypeMany, or OpTypeNone
	IsMock bool           // true if mock execution
	SQL    string         // executed SQL (bound for DB, original for mock)
	Params map[string]any // named parameters (for mock)
	Args   []any          // positional arguments (for DB)
}

type Recorder func(record Record)

type ResultBuilder[R any] interface {
	// BuildResult creates the result from output and transform context.
	BuildResult(output any, tc *js.TransformContext) *R
	// OnEmptyOne handles empty result for "one" type. Returns (result, error).
	// If error is non-nil, it's returned. If result is non-nil, it's returned.
	OnEmptyOne(tc *js.TransformContext) (*R, error)
}