flow

type Builtins interface {
	Print(msg string)
	Now() time.Time
}

type EventHandlerContext interface {
	HTTPDo(reqURL string, method string, query url.Values, header http.Header, body []byte) (*HTTPResponse, error)
	Select(cases *starlark.Dict, defaultCase starlark.Value, timeout time.Duration, timeoutValue starlark.Value) (starlark.Value, error)
	Signal(workflowID, signalName, payloadJSON, runID string) (bool, error)
	ReceiveChannel(channelName string) (Future, error)
	Sleep(duration time.Duration) error
	Timer(duration time.Duration) Future
	WorkflowID() string
	// Gather waits for all given futures. If returnList is false it returns the
	// single future's value; otherwise it returns a starlark.List of values.
	// If timeout is non-zero and elapses before all futures are ready, it returns
	// timeoutValue instead of a result.
	Gather(futures []Future, timeout time.Duration, timeoutValue starlark.Value, returnList bool) (starlark.Value, error)
	// Run schedules a built-in activity identified by uri and returns a Future
	// whose Get() yields the activity's decoded output value. args are the
	// remaining positional arguments in stringified form; their meaning is
	// uri-specific and opaque to the engine.
	Run(uri string, args []string) (Future, error)
}

type Future interface {
	Get() (starlark.Value, error)
	Unwrap() any
}

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

type HTTPResponse struct {
	Status     string
	StatusCode uint32
	Header     http.Header
	Body       []byte
}

type ModuleRef struct {
	// SourceName is the name of the source to use to fetch this module.
	// Empty string means the entrypoint project.
	SourceName string
	File       string
}

type ModuleSource struct {
	SourceName string
	File       string
	Data       []byte
}

type PreloadedRuntimeOptions struct {
	ProjectPath string
	Entrypoint  string
	Builtins    Builtins

	Modules []ModuleSource
}

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

type RuntimeOptions struct {
	ProjectPath string
	Entrypoint  string
	Builtins    Builtins

	Source Source
}

type ScriptOptions struct {
	Definition []byte
	Context    EventHandlerContext
	Builtins   Builtins
	// ExtraWMembers are merged into the `w` Starlark module alongside the
	// event-handler-context members (vars, http, sleep, run, ...). Used to
	// inject script-mode-only globals such as `w.secrets`.
	ExtraWMembers starlark.StringDict
}

type Source interface {
	// SetupThreadLocal configures thread local variables for this source.
	// projectPath is GitLab project path of the entrypoint project.
	SetupThreadLocal(thread *starlark.Thread, projectPath string)
	// RecordSource
	// fullGitRef is the full git reference:
	// - refs/heads/<name> for branches
	// - refs/tags/<name> for tags
	// - <commit id> for commits
	// - empty string or HEAD to use the default branch.
	RecordSource(thread *starlark.Thread, name, projectPath, fullGitRef string) error
	LoadFile(ctx context.Context, thread *starlark.Thread, ref ModuleRef) ([]byte, error)
}

type TestingSource = preloadedSource