Documentation ¶
Overview ¶
Package memory implements the database interface using in-memory database.
Index ¶
- type DB
- func (d *DB) ActivateClient(_ context.Context, projectID types.ID, key string) (*database.ClientInfo, error)
- func (d *DB) Close() error
- func (d *DB) CreateChangeInfos(_ context.Context, projectID types.ID, docInfo *database.DocInfo, ...) error
- func (d *DB) CreateProjectInfo(_ context.Context, name string, owner types.ID, ...) (*database.ProjectInfo, error)
- func (d *DB) CreateSnapshotInfo(_ context.Context, docID types.ID, doc *document.InternalDocument) error
- func (d *DB) CreateUserInfo(_ context.Context, username string, hashedPassword string) (*database.UserInfo, error)
- func (d *DB) DeactivateClient(_ context.Context, projectID, clientID types.ID) (*database.ClientInfo, error)
- func (d *DB) EnsureDefaultUserAndProject(ctx context.Context, username, password string, ...) (*database.UserInfo, *database.ProjectInfo, error)
- func (d *DB) FindChangeInfosBetweenServerSeqs(_ context.Context, docID types.ID, from int64, to int64) ([]*database.ChangeInfo, error)
- func (d *DB) FindChangesBetweenServerSeqs(ctx context.Context, docID types.ID, from int64, to int64) ([]*change.Change, error)
- func (d *DB) FindClientInfoByID(_ context.Context, projectID, clientID types.ID) (*database.ClientInfo, error)
- func (d *DB) FindClosestSnapshotInfo(_ context.Context, docID types.ID, serverSeq int64, includeSnapshot bool) (*database.SnapshotInfo, error)
- func (d *DB) FindDeactivateCandidates(ctx context.Context, candidatesLimitPerProject int, projectFetchSize int, ...) (types.ID, []*database.ClientInfo, error)
- func (d *DB) FindDocInfoByID(_ context.Context, projectID types.ID, id types.ID) (*database.DocInfo, error)
- func (d *DB) FindDocInfoByKey(_ context.Context, projectID types.ID, key key.Key) (*database.DocInfo, error)
- func (d *DB) FindDocInfoByKeyAndOwner(_ context.Context, projectID types.ID, clientID types.ID, key key.Key, ...) (*database.DocInfo, error)
- func (d *DB) FindDocInfosByPaging(_ context.Context, projectID types.ID, paging types.Paging[types.ID]) ([]*database.DocInfo, error)
- func (d *DB) FindDocInfosByQuery(_ context.Context, projectID types.ID, query string, pageSize int) (*types.SearchResult[*database.DocInfo], error)
- func (d *DB) FindMinSyncedSeqInfo(_ context.Context, docID types.ID) (*database.SyncedSeqInfo, error)
- func (d *DB) FindProjectInfoByID(_ context.Context, id types.ID) (*database.ProjectInfo, error)
- func (d *DB) FindProjectInfoByName(_ context.Context, owner types.ID, name string) (*database.ProjectInfo, error)
- func (d *DB) FindProjectInfoByPublicKey(_ context.Context, publicKey string) (*database.ProjectInfo, error)
- func (d *DB) FindSnapshotInfoByID(_ context.Context, id types.ID) (*database.SnapshotInfo, error)
- func (d *DB) FindUserInfo(_ context.Context, username string) (*database.UserInfo, error)
- func (d *DB) IsDocumentAttached(_ context.Context, projectID types.ID, docID types.ID, ...) (bool, error)
- func (d *DB) ListProjectInfos(_ context.Context, owner types.ID) ([]*database.ProjectInfo, error)
- func (d *DB) ListUserInfos(_ context.Context) ([]*database.UserInfo, error)
- func (d *DB) PurgeStaleChanges(_ context.Context, docID types.ID) error
- func (d *DB) UpdateAndFindMinSyncedTicket(ctx context.Context, clientInfo *database.ClientInfo, docID types.ID, ...) (*time.Ticket, error)
- func (d *DB) UpdateClientInfoAfterPushPull(_ context.Context, clientInfo *database.ClientInfo, docInfo *database.DocInfo) error
- func (d *DB) UpdateDocInfoStatusToRemoved(_ context.Context, projectID types.ID, id types.ID) error
- func (d *DB) UpdateProjectInfo(_ context.Context, owner types.ID, id types.ID, ...) (*database.ProjectInfo, error)
- func (d *DB) UpdateSyncedSeq(_ context.Context, clientInfo *database.ClientInfo, docID types.ID, ...) error
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type DB ¶
type DB struct {
// contains filtered or unexported fields
}
DB is an in-memory database for testing or temporarily.
func (*DB) ActivateClient ¶
func (d *DB) ActivateClient( _ context.Context, projectID types.ID, key string, ) (*database.ClientInfo, error)
ActivateClient activates a client.
func (*DB) CreateChangeInfos ¶
func (d *DB) CreateChangeInfos( _ context.Context, projectID types.ID, docInfo *database.DocInfo, initialServerSeq int64, changes []*change.Change, isRemoved bool, ) error
CreateChangeInfos stores the given changes and doc info. If the removeDoc condition is true, mark IsRemoved to true in doc info.
func (*DB) CreateProjectInfo ¶
func (d *DB) CreateProjectInfo( _ context.Context, name string, owner types.ID, clientDeactivateThreshold string, ) (*database.ProjectInfo, error)
CreateProjectInfo creates a new project.
func (*DB) CreateSnapshotInfo ¶
func (d *DB) CreateSnapshotInfo( _ context.Context, docID types.ID, doc *document.InternalDocument, ) error
CreateSnapshotInfo stores the snapshot of the given document.
func (*DB) CreateUserInfo ¶ added in v0.2.14
func (d *DB) CreateUserInfo( _ context.Context, username string, hashedPassword string, ) (*database.UserInfo, error)
CreateUserInfo creates a new user.
func (*DB) DeactivateClient ¶
func (d *DB) DeactivateClient(_ context.Context, projectID, clientID types.ID) (*database.ClientInfo, error)
DeactivateClient deactivates a client.
func (*DB) EnsureDefaultUserAndProject ¶ added in v0.2.14
func (d *DB) EnsureDefaultUserAndProject( ctx context.Context, username, password string, clientDeactivateThreshold string, ) (*database.UserInfo, *database.ProjectInfo, error)
EnsureDefaultUserAndProject creates the default user and project if they do not exist.
func (*DB) FindChangeInfosBetweenServerSeqs ¶
func (d *DB) FindChangeInfosBetweenServerSeqs( _ context.Context, docID types.ID, from int64, to int64, ) ([]*database.ChangeInfo, error)
FindChangeInfosBetweenServerSeqs returns the changeInfos between two server sequences.
func (*DB) FindChangesBetweenServerSeqs ¶
func (d *DB) FindChangesBetweenServerSeqs( ctx context.Context, docID types.ID, from int64, to int64, ) ([]*change.Change, error)
FindChangesBetweenServerSeqs returns the changes between two server sequences.
func (*DB) FindClientInfoByID ¶
func (d *DB) FindClientInfoByID(_ context.Context, projectID, clientID types.ID) (*database.ClientInfo, error)
FindClientInfoByID finds a client by ID.
func (*DB) FindClosestSnapshotInfo ¶
func (d *DB) FindClosestSnapshotInfo( _ context.Context, docID types.ID, serverSeq int64, includeSnapshot bool, ) (*database.SnapshotInfo, error)
FindClosestSnapshotInfo finds the last snapshot of the given document.
func (*DB) FindDeactivateCandidates ¶
func (d *DB) FindDeactivateCandidates( ctx context.Context, candidatesLimitPerProject int, projectFetchSize int, lastProjectID types.ID, ) (types.ID, []*database.ClientInfo, error)
FindDeactivateCandidates finds the clients that need housekeeping.
func (*DB) FindDocInfoByID ¶
func (d *DB) FindDocInfoByID( _ context.Context, projectID types.ID, id types.ID, ) (*database.DocInfo, error)
FindDocInfoByID finds a docInfo of the given ID.
func (*DB) FindDocInfoByKey ¶
func (d *DB) FindDocInfoByKey( _ context.Context, projectID types.ID, key key.Key, ) (*database.DocInfo, error)
FindDocInfoByKey finds the document of the given key.
func (*DB) FindDocInfoByKeyAndOwner ¶ added in v0.2.9
func (d *DB) FindDocInfoByKeyAndOwner( _ context.Context, projectID types.ID, clientID types.ID, key key.Key, createDocIfNotExist bool, ) (*database.DocInfo, error)
FindDocInfoByKeyAndOwner finds the document of the given key. If the createDocIfNotExist condition is true, create the document if it does not exist.
func (*DB) FindDocInfosByPaging ¶
func (d *DB) FindDocInfosByPaging( _ context.Context, projectID types.ID, paging types.Paging[types.ID], ) ([]*database.DocInfo, error)
FindDocInfosByPaging returns the documentInfos of the given paging.
func (*DB) FindDocInfosByQuery ¶ added in v0.2.13
func (d *DB) FindDocInfosByQuery( _ context.Context, projectID types.ID, query string, pageSize int, ) (*types.SearchResult[*database.DocInfo], error)
FindDocInfosByQuery returns the docInfos which match the given query.
func (*DB) FindMinSyncedSeqInfo ¶ added in v0.2.17
func (d *DB) FindMinSyncedSeqInfo( _ context.Context, docID types.ID, ) (*database.SyncedSeqInfo, error)
FindMinSyncedSeqInfo finds the minimum synced sequence info.
func (*DB) FindProjectInfoByID ¶ added in v0.2.8
FindProjectInfoByID returns a project by the given id.
func (*DB) FindProjectInfoByName ¶ added in v0.2.6
func (d *DB) FindProjectInfoByName( _ context.Context, owner types.ID, name string, ) (*database.ProjectInfo, error)
FindProjectInfoByName returns a project by the given name.
func (*DB) FindProjectInfoByPublicKey ¶
func (d *DB) FindProjectInfoByPublicKey( _ context.Context, publicKey string, ) (*database.ProjectInfo, error)
FindProjectInfoByPublicKey returns a project by public key.
func (*DB) FindSnapshotInfoByID ¶ added in v0.4.6
FindSnapshotInfoByID returns the snapshot by the given id.
func (*DB) FindUserInfo ¶ added in v0.2.14
FindUserInfo finds a user by the given username.
func (*DB) IsDocumentAttached ¶ added in v0.4.3
func (d *DB) IsDocumentAttached( _ context.Context, projectID types.ID, docID types.ID, excludeClientID types.ID, ) (bool, error)
IsDocumentAttached returns whether the document is attached to clients.
func (*DB) ListProjectInfos ¶
func (d *DB) ListProjectInfos( _ context.Context, owner types.ID, ) ([]*database.ProjectInfo, error)
ListProjectInfos returns all project infos owned by owner.
func (*DB) ListUserInfos ¶ added in v0.2.14
ListUserInfos returns all users.
func (*DB) PurgeStaleChanges ¶ added in v0.2.17
PurgeStaleChanges delete changes before the smallest in `syncedseqs` to save storage.
func (*DB) UpdateAndFindMinSyncedTicket ¶
func (d *DB) UpdateAndFindMinSyncedTicket( ctx context.Context, clientInfo *database.ClientInfo, docID types.ID, serverSeq int64, ) (*time.Ticket, error)
UpdateAndFindMinSyncedTicket updates the given serverSeq of the given client and returns the min synced ticket.
func (*DB) UpdateClientInfoAfterPushPull ¶
func (d *DB) UpdateClientInfoAfterPushPull( _ context.Context, clientInfo *database.ClientInfo, docInfo *database.DocInfo, ) error
UpdateClientInfoAfterPushPull updates the client from the given clientInfo after handling PushPull.
func (*DB) UpdateDocInfoStatusToRemoved ¶ added in v0.4.0
func (d *DB) UpdateDocInfoStatusToRemoved( _ context.Context, projectID types.ID, id types.ID, ) error
UpdateDocInfoStatusToRemoved updates the status of the document to removed.
func (*DB) UpdateProjectInfo ¶
func (d *DB) UpdateProjectInfo( _ context.Context, owner types.ID, id types.ID, fields *types.UpdatableProjectFields, ) (*database.ProjectInfo, error)
UpdateProjectInfo updates the given project.