block

type Block struct {
	Path        string
	Name        string
	Command     Command
	SQL         string
	Doc         string
	Line        int
	Column      int
	StartOffset int
	EndOffset   int
	Suffix      string
	ParamTypes  []ParamTypeOverride  // Explicit type overrides from @param comments
	ReturnTypes []ReturnTypeOverride // Explicit type overrides from @returns comments
	Cache       *cache.Annotation    // Cache annotation if present
	// OrderBy holds the allow-list of column names from an `-- @orderby col, col2`
	// annotation, in source order. It is only set when the query uses the dynamic
	// ORDER BY feature (a `@orderby` placeholder in the ORDER BY position). Nil for
	// every query that does not use the annotation, keeping output unchanged.
	OrderBy []string
	// Optional holds the names of optional equality-filter params from an
	// `-- @optional p1, p2` annotation, in source order. It is only set when the
	// query uses the optional-filters feature (each param wrapped in a
	// `(@p IS NULL OR <expr> <op> @p)` clause). Nil for every query that does not
	// use the annotation, keeping output unchanged.
	Optional []string
}

type Command int

type ParamTypeOverride struct {
	ParamName string
	GoType    string
}

type ReturnTypeOverride struct {
	ColumnName string
	GoType     string
}