69 lines
2.4 KiB
Go
69 lines
2.4 KiB
Go
package liveshare
|
|
|
|
import (
|
|
"context"
|
|
"fmt"
|
|
)
|
|
|
|
// A Session represents the session between a connected Live Share client and server.
|
|
type Session struct {
|
|
ssh *sshSession
|
|
rpc *rpcClient
|
|
|
|
// TODO(adonovan): fix: avoid data race of state accessed by
|
|
// multiple calls to StartSharing and concurrent calls to
|
|
// PortForwarder. Perhaps combine the two operations in the API?
|
|
streamName, streamCondition string
|
|
}
|
|
|
|
// Port describes a port exposed by the container.
|
|
type Port struct {
|
|
SourcePort int `json:"sourcePort"`
|
|
DestinationPort int `json:"destinationPort"`
|
|
SessionName string `json:"sessionName"`
|
|
StreamName string `json:"streamName"`
|
|
StreamCondition string `json:"streamCondition"`
|
|
BrowseURL string `json:"browseUrl"`
|
|
IsPublic bool `json:"isPublic"`
|
|
IsTCPServerConnectionEstablished bool `json:"isTCPServerConnectionEstablished"`
|
|
HasTSLHandshakePassed bool `json:"hasTSLHandshakePassed"`
|
|
// ^^^
|
|
// TODO(adonovan): fix possible typo in field name, and audit others.
|
|
}
|
|
|
|
// StartSharing tells the Live Share host to start sharing the specified port from the container.
|
|
// The sessionName describes the purpose of the port or service.
|
|
func (s *Session) StartSharing(ctx context.Context, sessionName string, port int) error {
|
|
var response Port
|
|
if err := s.rpc.do(ctx, "serverSharing.startSharing", []interface{}{
|
|
port, sessionName, fmt.Sprintf("http://localhost:%d", port),
|
|
}, &response); err != nil {
|
|
return err
|
|
}
|
|
|
|
s.streamName = response.StreamName
|
|
s.streamCondition = response.StreamCondition
|
|
|
|
return nil
|
|
}
|
|
|
|
// GetSharedServers returns a description of each container port
|
|
// shared by a prior call to StartSharing by some client.
|
|
func (s *Session) GetSharedServers(ctx context.Context) ([]*Port, error) {
|
|
var response []*Port
|
|
if err := s.rpc.do(ctx, "serverSharing.getSharedServers", []string{}, &response); err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
return response, nil
|
|
}
|
|
|
|
// UpdateSharedVisibility controls port permissions and whether it can be accessed publicly
|
|
// via the Browse URL
|
|
func (s *Session) UpdateSharedVisibility(ctx context.Context, port int, public bool) error {
|
|
if err := s.rpc.do(ctx, "serverSharing.updateSharedServerVisibility", []interface{}{port, public}, nil); err != nil {
|
|
return err
|
|
}
|
|
|
|
return nil
|
|
}
|