generator

type ClientGeneratorConfig struct {
	// The name of the module to generate for.
	ModuleName string

	// The list of all dependencies used by the module.
	// This is used by the client generator to automatically serves the
	// dependencies when connecting to the client.
	ModuleDependencies []ModuleSourceDependency

	// The directory where the client will be generated.
	ClientDir string
}

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

type Config struct {
	// Lang is the language to generate the module for.
	Lang SDKLang

	// OutputDir is the path to put the generated code.
	// Usually this is the path to the module source directory.
	// This allows generating extra file aside the client bindings
	// like go.mod, go.sum etc...
	OutputDir string

	// IntrospectionJSON is an optional pre-computed introspection json string.
	IntrospectionJSON string

	// A dagger client connected to the engine running the codegen.
	// This may be nil if the codegen is run outside of a dagger context and should
	// only be set if introspectionJSON or moduleSourceID are set.
	Dag *dagger.Client

	// Generate the client in bundle mode.
	Bundle bool

	// ModuleConfig is the specific config to generate module.
	ModuleConfig *ModuleGeneratorConfig

	// ClientConfig is the specific config to generate standalone client.
	ClientConfig *ClientGeneratorConfig
}

type FormatTypeFuncs interface {
	WithScope(scope string) FormatTypeFuncs

	FormatKindList(representation string) string
	FormatKindScalarString(representation string) string
	FormatKindScalarInt(representation string) string
	FormatKindScalarFloat(representation string) string
	FormatKindScalarBoolean(representation string) string
	FormatKindScalarDefault(representation string, refName string, input bool) string
	FormatKindObject(representation string, refName string, input bool) string
	FormatKindInputObject(representation string, refName string, input bool) string
	FormatKindEnum(representation string, refName string) string
}

type GeneratedState struct {
	// Overlay is the overlay filesystem that contains generated code to write
	// over the output directory.
	Overlay fs.FS

	// PostCommands are commands that need to be run after the codegen has
	// finished. This is used for example to run `go mod tidy` after generating
	// Go code.
	PostCommands []*exec.Cmd

	// NeedRegenerate indicates that the code needs to be generated again. This
	// can happen if the codegen spat out templates that depend on generated
	// types. In that case the codegen needs to be run again with both the
	// templates and the initially generated types available.
	NeedRegenerate bool
}

type Generator interface {
	// GenerateModule runs codegen in a context of a module and returns a map of
	// default filename to content for that file.
	GenerateModule(ctx context.Context, schema *introspection.Schema, schemaVersion string) (*GeneratedState, error)

	// GenerateClient runs codegen in a context of a standalone client and returns
	// a map of default filename to content for that file.
	GenerateClient(ctx context.Context, schema *introspection.Schema, schemaVersion string) (*GeneratedState, error)

	// GenerateLibrary only generate the library bindings for the given schema.
	GenerateLibrary(ctx context.Context, schema *introspection.Schema, schemaVersion string) (*GeneratedState, error)
}

type ModuleGeneratorConfig struct {
	// Name of the module to generate code for.
	ModuleName string

	// ModuleSourcePath is the subpath in OutputDir where the module source subpath is located.
	ModuleSourcePath string

	// ModuleParentPath is the path from the module source subpath to the context directory
	ModuleParentPath string

	// Whether we are initializing a new module.
	// Currently, this is only used in go codegen to enforce backwards-compatible behavior
	// where a pre-existing go.mod file is checked during dagger init for whether its module
	// name is the expected value.
	IsInit bool
}

type ModuleSourceDependency struct {
	Kind   string
	Name   string `json:"moduleOriginalName"`
	Pin    string
	Source string `json:"asString"`
}

type SDKLang string