117 lines
6.7 KiB
Go
117 lines
6.7 KiB
Go
// Package database provides a client for using the OtterSpace API.
|
|
//
|
|
// This package provides a client to interact with the OtterSpace API. It includes
|
|
// methods for all API endpoints, and convenience methods for common tasks.
|
|
//
|
|
// This is a simple usage example:
|
|
//
|
|
// package main
|
|
//
|
|
// import (
|
|
// "context"
|
|
// "fmt"
|
|
// "git.dragse.it/anthrove/otter-space-sdk/pkg/models"
|
|
// "git.dragse.it/anthrove/otter-space-sdk/pkg/database"
|
|
// )
|
|
//
|
|
// func main() {
|
|
// client := database.NewGraphConnection()
|
|
// err := client.Connect(context.Background(), "your-endpoint", "your-username", "your-password")
|
|
// if err != nil {
|
|
// fmt.Println(err)
|
|
// return
|
|
// }
|
|
// // further usage of the client...
|
|
// }
|
|
package database
|
|
|
|
import (
|
|
"context"
|
|
"git.dragse.it/anthrove/otter-space-sdk/pkg/models"
|
|
"git.dragse.it/anthrove/otter-space-sdk/pkg/models/graphModels"
|
|
)
|
|
|
|
// OtterSpace provides an interface for interacting with the OtterSpace API.
|
|
// It includes methods for connecting to the API, adding and linking users, posts, and sources,
|
|
// and retrieving information about users and posts.
|
|
type OtterSpace interface {
|
|
// Connect sets up a connection to the OtterSpace API endpoint using the provided username and password.
|
|
// It returns an error if the connection cannot be established.
|
|
Connect(ctx context.Context, endpoint string, username string, password string, database string, port int, ssl string, timezone string) error
|
|
|
|
// AddUserWithRelationToSource adds a new user to the OtterSpace database and associates them with a source.
|
|
// It returns the newly created user and an error if the operation fails.
|
|
AddUserWithRelationToSource(ctx context.Context, anthroveUserID models.AnthroveUserID, sourceDomain string, userID string, username string) error
|
|
|
|
// AddSource adds a new source to the OtterSpace database.
|
|
// It returns an error if the operation fails.
|
|
AddSource(ctx context.Context, anthroveSource *graphModels.AnthroveSource) error
|
|
|
|
// AddPost adds a new post to the OtterSpace database.
|
|
// It returns an error if the operation fails.
|
|
AddPost(ctx context.Context, anthrovePost *graphModels.AnthrovePost) error
|
|
|
|
// AddTagWithRelationToPost adds a new tag to the OtterSpace database and associates it with a post.
|
|
// It returns an error if the operation fails.
|
|
AddTagWithRelationToPost(ctx context.Context, anthrovePostID models.AnthrovePostID, anthroveTag *graphModels.AnthroveTag) error
|
|
|
|
// LinkPostWithSource establishes a link between a post and a source in the OtterSpace database.
|
|
// It returns an error if the operation fails.
|
|
LinkPostWithSource(ctx context.Context, anthrovePostID models.AnthrovePostID, anthroveSourceDomain string, anthrovePostRelationship *graphModels.AnthrovePostRelationship) error
|
|
|
|
// LinkUserWithPost establishes a link between a user and a post in the OtterSpace database.
|
|
// It returns an error if the operation fails.
|
|
LinkUserWithPost(ctx context.Context, anthroveUser *graphModels.AnthroveUser, anthrovePost *graphModels.AnthrovePost) error
|
|
|
|
// CheckUserPostLink checks if a link between a user and a post exists in the OtterSpace database.
|
|
// It returns true if the link exists, false otherwise, and an error if the operation fails.
|
|
CheckUserPostLink(ctx context.Context, anthroveUserID models.AnthroveUserID, sourcePostID string, sourceUrl string) (bool, error)
|
|
|
|
// CheckPostNodeExistsByAnthroveID checks if a post node exists in the OtterSpace database by its Anthrove ID.
|
|
// It returns the post if it exists, a boolean indicating whether the post was found, and an error if the operation fails.
|
|
CheckPostNodeExistsByAnthroveID(ctx context.Context, anthrovePost *graphModels.AnthrovePost) (*graphModels.AnthrovePost, bool, error)
|
|
|
|
// CheckPostNodeExistsBySourceURL checks if a post node exists in the OtterSpace database by its source URL.
|
|
// It returns the post if it exists, a boolean indicating whether the post was found, and an error if the operation fails.
|
|
CheckPostNodeExistsBySourceURL(ctx context.Context, sourceUrl string) (*graphModels.AnthrovePost, bool, error)
|
|
|
|
// CheckPostNodeExistsBySourceID checks if a post node exists in the OtterSpace database by its source ID.
|
|
// It returns the post if it exists, a boolean indicating whether the post was found, and an error if the operation fails.
|
|
CheckPostNodeExistsBySourceID(ctx context.Context, sourcePostID string) (*graphModels.AnthrovePost, bool, error)
|
|
|
|
// GetUserFavoriteCount retrieves the count of a user's favorite posts from the OtterSpace database.
|
|
// It returns the count and an error if the operation fails.
|
|
GetUserFavoriteCount(ctx context.Context, anthroveUserID models.AnthroveUserID) (int64, error)
|
|
|
|
// GetUserSourceLinks retrieves the links between a user and sources in the OtterSpace database.
|
|
// It returns a map of source domains to user-source relationships, and an error if the operation fails.
|
|
GetUserSourceLinks(ctx context.Context, anthroveUserID models.AnthroveUserID) (map[string]graphModels.AnthroveUserRelationship, error)
|
|
|
|
// GetSpecifiedUserSourceLink GetUserSourceLinks retrieves the links between a user and a specific source in the OtterSpace database.
|
|
// It returns a map of source domains to user-source relationships, and an error if the operation fails.
|
|
GetSpecifiedUserSourceLink(ctx context.Context, anthroveUserID models.AnthroveUserID, sourceDisplayName string) (map[string]graphModels.AnthroveUserRelationship, error)
|
|
|
|
// GetAnthroveUser retrieves a user from the OtterSpace database by their ID.
|
|
// It returns the user and an error if the operation fails.
|
|
GetAnthroveUser(ctx context.Context, anthroveUserID models.AnthroveUserID) (*graphModels.AnthroveUser, error)
|
|
|
|
// GetAllAnthroveUserIDs retrieves all user IDs from the OtterSpace database.
|
|
// It returns a slice of user IDs and an error if the operation fails.
|
|
GetAllAnthroveUserIDs(ctx context.Context) ([]models.AnthroveUserID, error)
|
|
|
|
// GetUserFavoritePostsWithPagination gets all user favorites with relation and sources for the given user
|
|
GetUserFavoritePostsWithPagination(ctx context.Context, anthroveUserID models.AnthroveUserID, skip int, limit int) (*graphModels.FavoriteList, error)
|
|
|
|
// GetUserTagsTroughFavedPosts returns a list of Tags that the user hs favorites through a post
|
|
GetUserTagsTroughFavedPosts(ctx context.Context, anthroveUserID models.AnthroveUserID) ([]graphModels.TagsWithFrequency, error)
|
|
|
|
// GetAllTags returns a list of Tags that the user hs favorites through a post
|
|
GetAllTags(ctx context.Context) ([]graphModels.TagsWithFrequency, error)
|
|
|
|
// GetAllSources returns a list of Sources in the database
|
|
GetAllSources(ctx context.Context) ([]graphModels.AnthroveSource, error)
|
|
|
|
// GetSourceByURL returns the Source Node based on the URL
|
|
GetSourceByURL(ctx context.Context, sourceUrl string) (*graphModels.AnthroveSource, error)
|
|
}
|