ext

type Event string

type EventDispatcher[T any] struct {
	// contains filtered or unexported fields
}

type EventHandlerFn[T any] func(ctx context.Context, args T) error

type HookConfig struct {

	// Internal name of the hook running for a given command
	Name string `yaml:",omitempty"`
	// Kind specifies the executor type of the hook script.
	// Allowed values: "sh", "pwsh", "js", "ts", "python", "dotnet".
	// When empty, the kind is auto-detected from the file extension
	// of the run path (e.g. .py → python, .ps1 → pwsh). If Kind
	// and Shell are both empty and run references a file,
	// the extension is used. For inline scripts, Kind or Shell
	// must be set explicitly.
	Kind language.HookKind `yaml:"kind,omitempty" json:"kind,omitempty"`
	// Shell is a deprecated alias for Kind. When set in YAML
	// (shell: sh) it is mapped to Kind during validate().
	// Retained for backwards compatibility with legacy configs.
	Shell string `yaml:"shell,omitempty" json:"-"`
	// Dir specifies the working directory for hook execution,
	// used as the project context for dependency installation and builds.
	// When empty, defaults to the directory containing the script
	// referenced by the run field. Only set this when the project root
	// differs from the script's directory.
	Dir string `yaml:"dir,omitempty" json:"dir,omitempty"`
	// The inline script to execute or path to existing file
	Run string `yaml:"run,omitempty"`
	// When set to true will not halt command execution even when a script error occurs.
	ContinueOnError bool `yaml:"continueOnError,omitempty"`
	// When set to true will bind the stdin, stdout & stderr to the running console
	Interactive bool `yaml:"interactive,omitempty"`
	// When running on windows use this override config
	Windows *HookConfig `yaml:"windows,omitempty"`
	// When running on linux/macos use this override config
	Posix *HookConfig `yaml:"posix,omitempty"`
	// Environment variables in this list are added to the hook script and if the value is a akvs:// reference
	// it will be resolved to the secret value
	Secrets map[string]string `yaml:"secrets,omitempty"`
	// Config is an optional property bag of executor-specific settings,
	// discriminated by Kind. Each executor may unmarshal this into a
	// strongly-typed struct for its own configuration needs.
	Config map[string]any `yaml:"config,omitempty"`
	// contains filtered or unexported fields
}

type HookFilterPredicateFn func(scriptName string, hookConfig *HookConfig) bool

type HookPlatformType string

type HookType string

type HookValidationResult struct {
	Warnings []HookWarning
}

type HookWarning struct {
	Message    string
	Suggestion string
	URL        string
}

type HooksConfig map[string][]*HookConfig

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

type HooksManagerOptions struct {
	Cwd        string // Working directory for resolving relative hook paths
	ProjectDir string // Project root (azure.yaml location) for security boundary
}

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

type InvokeFn func() error