types

Documentation

Index

• Variables
• func IsAuthMethod(method string) bool
• type AccessAttribute
• type AccessInfo
• type AuthWebhookRequest
  • func NewAuthWebhookRequest(reader io.Reader) (*AuthWebhookRequest, error)
• type AuthWebhookResponse
  • func NewAuthWebhookResponse(reader io.Reader) (*AuthWebhookResponse, error)
  • func (r *AuthWebhookResponse) Write(writer io.Writer) (int, error)
• type ChangeSummary
• type Client
  • func NewClient(encoded []byte) (*Client, error)
  • func (c *Client) Marshal() (string, error)
• type DocEventType
• type Metadata
• type MetadataInfo
  • func (i *MetadataInfo) Update(info MetadataInfo) bool
• type Method
  • func AuthMethods() []Method
• type VerbType

Variables

var (
	// ErrInvalidWebhookRequest is returned when the given webhook request is not valid.
	ErrInvalidWebhookRequest = errors.New("invalid authorization webhook request")

	// ErrInvalidWebhookResponse is returned when the given webhook response is not valid.
	ErrInvalidWebhookResponse = errors.New("invalid authorization webhook response")
)

Functions

func IsAuthMethod

func IsAuthMethod(method string) bool

IsAuthMethod returns whether the given method can be used for authorization.

Types

type AccessAttribute

type AccessAttribute struct {
	Key  string   `json:"key"`
	Verb VerbType `json:"verb"`
}

AccessAttribute represents an access attribute.

type AccessInfo

type AccessInfo struct {
	Method     Method
	Attributes []AccessAttribute
}

AccessInfo represents an access information.

type AuthWebhookRequest

type AuthWebhookRequest struct {
	Token      string            `json:"token"`
	Method     Method            `json:"method"`
	Attributes []AccessAttribute `json:"attributes"`
}

AuthWebhookRequest represents the request of authentication webhook.

func NewAuthWebhookRequest

func NewAuthWebhookRequest(reader io.Reader) (*AuthWebhookRequest, error)

NewAuthWebhookRequest creates a new instance of AuthWebhookRequest.

type AuthWebhookResponse

type AuthWebhookResponse struct {
	Allowed bool   `json:"allowed"`
	Reason  string `json:"reason"`
}

AuthWebhookResponse represents the response of authentication webhook.

func NewAuthWebhookResponse

func NewAuthWebhookResponse(reader io.Reader) (*AuthWebhookResponse, error)

NewAuthWebhookResponse creates a new instance of AuthWebhookResponse.

func (*AuthWebhookResponse) Write

func (r *AuthWebhookResponse) Write(writer io.Writer) (int, error)

Write writes this response to the given writer.

type ChangeSummary

type ChangeSummary struct {
	// ID is the unique identifier of the change.
	ID change.ID

	// Message is the message of the change.
	Message string

	// Snapshot is the snapshot of the document.
	Snapshot string
}

ChangeSummary represents a summary of change.

type Client

type Client struct {
	ID           time.ActorID
	MetadataInfo MetadataInfo
}

Client represents the Client that communicates with the Agent.

func NewClient

func NewClient(encoded []byte) (*Client, error)

NewClient creates a new Client from the given JSON.

func (*Client) Marshal

func (c *Client) Marshal() (string, error)

Marshal serializes the Client to JSON.

type DocEventType

type DocEventType string

DocEventType represents the event that the Agent delivers to the client.

const (
	// DocumentsChangedEvent is an event indicating that documents are being
	// modified by a change.
	DocumentsChangedEvent DocEventType = "documents-changed"

	// DocumentsWatchedEvent is an event that occurs when documents are watched
	// by other clients.
	DocumentsWatchedEvent DocEventType = "documents-watched"

	// DocumentsUnwatchedEvent is an event that occurs when documents are
	// unwatched by other clients.
	DocumentsUnwatchedEvent DocEventType = "documents-unwatched"

	// MetadataChangedEvent is an event indicating that metadata is changed.
	MetadataChangedEvent DocEventType = "metadata-changed"
)

type Metadata

type Metadata map[string]string

Metadata represents custom metadata that can be defined in the client.

type MetadataInfo

type MetadataInfo struct {
	Clock int32
	Data  Metadata
}

MetadataInfo is a metadata information with logical clock.

func (*MetadataInfo) Update

func (i *MetadataInfo) Update(info MetadataInfo) bool

Update updates the given metadata information with the given clock.

type Method

type Method string

Method represents a method name of RPC.

const (
	ActivateClient   Method = "ActivateClient"
	DeactivateClient Method = "DeactivateClient"
	AttachDocument   Method = "AttachDocument"
	DetachDocument   Method = "DetachDocument"
	PushPull         Method = "PushPull"
	WatchDocuments   Method = "WatchDocuments"
	FetchHistory     Method = "FetchHistory"
)

Belows are the names of RPCs.

func AuthMethods

func AuthMethods() []Method

AuthMethods returns a slice of methods that can be used for authorization.

type VerbType

type VerbType string

VerbType represents an action taken on the document.

const (

	// Read represents the case of only reading the given document.
	Read VerbType = "r"

	// ReadWrite represents the case of reading and writing the given document.
	ReadWrite VerbType = "rw"
)