aj

type Application interface {
	// ID returns a unique app identifier. This should be a domain
	// name in reverse. Here are some examples:
	//
	//   com.example.SomeApp
	//   xyz.holanet.Garden
	ID() string
}

type Cleanupable interface {
	// Cleanup performs cleanup operations such as freeing resources associated
	// with the object. It must return when or before the context expires, and
	// must return ctx.Err if there is no other error to be returned.
	Cleanup(ctx context.Context) error
}

type Described interface {
	// Description returns a user-readable description of the application.
	Description() string
}

type Initializable interface {
	// Init initializes the object. It must return before the context
	// expires, and must return ctx.Err if there is no other error to be
	// returned. If Init returns an error, the object must be treated as
	// invalid and any process which depends on it should be shut down.
	Init(ctx context.Context) error
}

type Named interface {
	// Name returns a user-readable name for the application.
	Name() string
}

type RunShutdownable interface {
	// Run is similar to [Runnable.Run], but takes no context and blocks
	// until Shutdown has run and exited. It may also return when something
	// goes wrong and it cannot continue, in which case it must return a
	// non-nil error explaining why. Shutdown does not need to be called in
	// the latter case.
	Run() error
	// Shutdown shuts down the actor. It must unblock Run in all cases even
	// on failure, context expiration, etc. Shutdown must return when or
	// before the context expires, and must return ctx.Err if there is no
	// other error to be returned. If Shutdown returns any error, the object
	// must be treated as invalid and any other process which depends on it
	// should be shut down.
	Shutdown(ctx context.Context) error
}

type RunShutdownableShim struct {
	RunShutdownable
	// contains filtered or unexported fields
}

type Runnable interface {
	// Run runs the object. It must return when or before the context
	// expires, and must return ctx.Err if there is no other error to be
	// returned.
	Run(ctx context.Context) error
}