service

type AddInManager interface {
	extension.AddInManager
	// contains filtered or unexported methods
}

type AddInStatus interface {
	extension.AddInStatus
	// contains filtered or unexported methods
}

type Caller interface {
	Submit(entityID uid.Id, fun generic.FuncVar1[ec.Entity, any, async.Result], args ...any) async.Future
	SubmitDelegate(entityID uid.Id, fun generic.DelegateVar1[ec.Entity, any, async.Result], args ...any) async.Future
	SubmitVoid(entityID uid.Id, fun generic.ActionVar1[ec.Entity, any], args ...any) async.Future
	SubmitDelegateVoid(entityID uid.Id, fun generic.DelegateVoidVar1[ec.Entity, any], args ...any) async.Future
	Post(entityID uid.Id, fun generic.ActionVar1[ec.Entity, any], args ...any) error
	PostDelegate(entityID uid.Id, fun generic.DelegateVoidVar1[ec.Entity, any], args ...any) error
}

type Context interface {
	corectx.Context
	reinterpret.InstanceProvider
	extension.AddInProvider
	pt.EntityPTProvider
	Caller
	fmt.Stringer

	// Name 返回服务名称。
	Name() string
	// Id 返回服务的持久化 ID。
	Id() uid.Id
	// Reflected 返回实际服务上下文实例的反射值。
	Reflected() reflect.Value
	// EntityManager 返回并发安全的全局实体索引。
	EntityManager() EntityManager
	// contains filtered or unexported methods
}

type ContextBehavior struct {
	corectx.ContextBehavior
	// contains filtered or unexported fields
}

type ContextOptions struct {
	InstanceFace   iface.Face[Context] // 自定义上下文实例及其接口缓存。
	Context        context.Context     // 父上下文；nil 时使用 context.Background。
	AutoRecover    bool                // 回调发生 panic 时是否自动恢复。
	ReportError    chan error          // 自动恢复后接收 panic 错误的通道。
	Name           string              // 服务名称。
	PersistId      uid.Id              // 服务持久化 ID；为 Nil 时自动生成。
	EntityLib      pt.EntityLib        // 实体原型库；nil 时创建独立实体库。
	AddInManager   AddInManager        // 服务插件管理器；nil 时创建默认管理器。
	RunningEventCB RunningEventCB      // 服务运行事件回调。
}

type EntityManager interface {
	// GetEntity 按 ID 查询全局实体。
	GetEntity(id uid.Id) (ec.ConcurrentEntity, bool)
	// GetOrAddEntity 原子地查询或注册全局实体，并报告该 ID 是否已经存在。
	GetOrAddEntity(entity ec.ConcurrentEntity) (ec.ConcurrentEntity, bool, error)
	// RemoveEntity 按 ID 注销全局实体；实体不存在时不执行任何操作。
	RemoveEntity(id uid.Id)
}

type RunningEvent int32

type RunningEventCB = generic.ActionVar2[Context, RunningEvent, any] // 服务运行事件回调。