transport

type Client interface {
	// SignIn signs the client into a user
	SignIn(email, password string) (*gqlmod.Session, error)

	// SignInDebug signs the client into a debug user
	SignInDebug(username, password string) error

	// Auth authenticates the client by a user session key
	Auth(sessionKey string) (*gqlmod.Session, error)

	// Query performs an API query
	Query(query string, result interface{}) error

	// QueryVar performs a parameterized API query
	QueryVar(
		query string,
		vars map[string]interface{},
		result interface{},
	) error
}

type OnAuth func(ctx context.Context, sessionKey string) (store.ID, time.Time)

type OnDebugAuth func(ctx context.Context, sessionKey string) bool

type OnDebugSess func(ctx context.Context, username, password string) []byte

type OnGraphQuery func(context.Context, graph.Query) (graph.Response, error)

type Server interface {
	// Init initializes the server transport implementation.
	// The provided callbacks must be registered and invoked accordingly
	Init(
		onGraphQuery OnGraphQuery,
		onAuth OnAuth,
		onDebugAuth OnDebugAuth,
		onDebugSess OnDebugSess,
		debugLog *log.Logger,
		errorLog *log.Logger,
	) error

	// Run starts serving. Blocks until the underlying server is shut down
	Run() error

	// Shutdown instructs the underlying server to shut down and blocks until
	// it is
	Shutdown(ctx context.Context) error
}