Files

55 lines
2.1 KiB
Go

// Package store defines typed persistence operations and storage errors.
package store
import (
"context"
"errors"
"github.com/google/uuid"
"gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/model/dto"
)
var (
// ErrUnavailable means a required storage dependency cannot serve the operation.
ErrUnavailable = errors.New("storage unavailable")
// ErrNotFound means a record does not exist.
ErrNotFound = errors.New("record not found")
// ErrConflict means a unique constraint failed.
ErrConflict = errors.New("record already exists")
// ErrCapacity means the bounded store cannot accept more data.
ErrCapacity = errors.New("storage capacity reached")
)
// Interface defines persistence operations on validated typed records.
// Implementations own atomicity, unique constraints and storage capacity, but not
// authorization. Callers must validate membership before accessing chat records.
type Interface interface {
// CreateUser atomically enforces username uniqueness and assigns CreatedAt.
CreateUser(ctx context.Context, user dto.UserDTO) (dto.UserDTO, error)
// User returns a user by ID or ErrNotFound.
User(ctx context.Context, id uuid.UUID) (dto.UserDTO, error)
// UsersExist reports whether every supplied ID exists; an empty set returns true.
UsersExist(ctx context.Context, ids []uuid.UUID) (bool, error)
// CreateChat atomically stores a chat and its member indexes, assigning CreatedAt.
CreateChat(ctx context.Context, chat dto.ChatDTO) (dto.ChatDTO, error)
// Chat returns a defensive copy of the stored chat or ErrNotFound.
Chat(ctx context.Context, id uuid.UUID) (dto.ChatDTO, error)
// Chats reads up to limit records after position from the user's chat index.
Chats(ctx context.Context, userID uuid.UUID, position dto.PositionDTO, limit int) ([]dto.ChatDTO, error)
// CreateMessage appends one message atomically and assigns its ordering timestamp.
CreateMessage(ctx context.Context, message dto.MessageDTO) (dto.MessageDTO, error)
// Messages reads up to limit records strictly after position in one chat.
Messages(ctx context.Context, chatID uuid.UUID, position dto.PositionDTO, limit int) ([]dto.MessageDTO, error)
}