rpc

type ClientEventData struct {
	EventName string
	EventArgs []string
}

type InvocationResult struct {
	Synchronous bool
	Value       string // if synchronous
	AsyncResult <-chan PromiseResult
}

type PageUserTuple struct {
	Page string
	User string
}

type PromiseResult struct {
	Rejected       bool
	Value          goja.Value
	JSONMarshaller goja.Callable
}

type RPCModule interface {
	modules.NativeModule
	// HandleInvocation must be called inside the event loop
	// returns either a goja.Value (if the method handler is synchronous) or a channel where a goja.Value will later be sent (if the method handler returns a Promise)
	HandleInvocation(vm *goja.Runtime, user auth.User, pageID, method string, args []string) InvocationResult
	// HandleEvent must be called inside the event loop
	HandleEvent(vm *goja.Runtime, user auth.User, trusted bool, pageID, event string, args []string)

	GlobalEventEmitted() event.Event[ClientEventData]
	PageEventEmitted() event.Keyed[string, ClientEventData]
	UserEventEmitted() event.Keyed[string, ClientEventData]
	PageUserEventEmitted() event.Keyed[PageUserTuple, ClientEventData]
}