Struct Interface

dagql/interfaces.go:20–40

Interface represents a GraphQL Interface type in dagql. Unlike Class (which represents object types), an Interface only declares field *specs* — it has no resolvers of its own. Concrete objects that implement the interface provide the actual field implementations.

// field *specs* — it has no resolvers of its own. Concrete objects that
// implement the interface provide the actual field implementations.
type Interface struct {
	name        string
	description string
	fields      map[string][]*InterfaceFieldSpec
	fieldsL     *sync.Mutex

	// relationsL protects the schema relationships that can change after an
	// interface has been installed. Query parsing reads implementors to decide
	// whether fragment type conditions apply, while module schema construction can
	// register implementations concurrently for dependency-aware schemas.
	relationsL *sync.RWMutex
	directives []*ast.Directive

	// implementors tracks which object types implement this interface.
	// Keys are type names.
	implementors map[string]struct{}

	// interfaces tracks which other interfaces this interface implements.
	// Keys are interface names.
	interfaces map[string]*Interface
}

// InterfaceFieldSpec pairs a FieldSpec with optional view gating,
// mirroring how object fields work.