// Package db provides database access and migration management. package db import ( "context" "database/sql" "embed" "fmt" "io/fs" "log/slog" "sort" "strconv" "strings" "git.eeqj.de/sneak/chat/internal/config" "git.eeqj.de/sneak/chat/internal/logger" "git.eeqj.de/sneak/chat/internal/models" "go.uber.org/fx" _ "github.com/joho/godotenv/autoload" // loads .env file _ "modernc.org/sqlite" // SQLite driver ) const ( minMigrationParts = 2 ) // SchemaFiles contains embedded SQL migration files. // //go:embed schema/*.sql var SchemaFiles embed.FS // Params defines the dependencies for creating a Database. type Params struct { fx.In Logger *logger.Logger Config *config.Config } // Database manages the SQLite database connection and migrations. type Database struct { db *sql.DB log *slog.Logger params *Params } // New creates a new Database instance and registers lifecycle hooks. func New(lc fx.Lifecycle, params Params) (*Database, error) { s := new(Database) s.params = ¶ms s.log = params.Logger.Get() s.log.Info("Database instantiated") lc.Append(fx.Hook{ OnStart: func(ctx context.Context) error { s.log.Info("Database OnStart Hook") return s.connect(ctx) }, OnStop: func(_ context.Context) error { s.log.Info("Database OnStop Hook") if s.db != nil { return s.db.Close() } return nil }, }) return s, nil } // NewTest creates a Database for testing, bypassing fx lifecycle. // It connects to the given DSN and runs all migrations. func NewTest(dsn string) (*Database, error) { d, err := sql.Open("sqlite", dsn) if err != nil { return nil, err } s := &Database{ db: d, log: slog.Default(), } ctx := context.Background() err = s.runMigrations(ctx) if err != nil { _ = d.Close() return nil, err } return s, nil } // GetDB returns the underlying sql.DB connection. func (s *Database) GetDB() *sql.DB { return s.db } // Hydrate injects the database reference into any model that // embeds Base. func (s *Database) Hydrate(m interface{ SetDB(d models.DB) }) { m.SetDB(s) } // CreateUser inserts a new user into the database. func (s *Database) CreateUser( ctx context.Context, id, nick, passwordHash string, ) (*models.User, error) { _, err := s.db.ExecContext(ctx, `INSERT INTO users (id, nick, password_hash) VALUES (?, ?, ?)`, id, nick, passwordHash, ) if err != nil { return nil, err } u := &models.User{ ID: id, Nick: nick, PasswordHash: passwordHash, } s.Hydrate(u) return u, nil } // CreateChannel inserts a new channel into the database. func (s *Database) CreateChannel( ctx context.Context, id, name, topic, modes string, ) (*models.Channel, error) { _, err := s.db.ExecContext(ctx, `INSERT INTO channels (id, name, topic, modes) VALUES (?, ?, ?, ?)`, id, name, topic, modes, ) if err != nil { return nil, err } c := &models.Channel{ ID: id, Name: name, Topic: topic, Modes: modes, } s.Hydrate(c) return c, nil } // AddChannelMember adds a user to a channel with the given modes. func (s *Database) AddChannelMember( ctx context.Context, channelID, userID, modes string, ) (*models.ChannelMember, error) { _, err := s.db.ExecContext(ctx, `INSERT INTO channel_members (channel_id, user_id, modes) VALUES (?, ?, ?)`, channelID, userID, modes, ) if err != nil { return nil, err } cm := &models.ChannelMember{ ChannelID: channelID, UserID: userID, Modes: modes, } s.Hydrate(cm) return cm, nil } // CreateMessage inserts a new message into the database. func (s *Database) CreateMessage( ctx context.Context, id, fromUserID, fromNick, target, msgType, body string, ) (*models.Message, error) { _, err := s.db.ExecContext(ctx, `INSERT INTO messages (id, from_user_id, from_nick, target, type, body) VALUES (?, ?, ?, ?, ?, ?)`, id, fromUserID, fromNick, target, msgType, body, ) if err != nil { return nil, err } m := &models.Message{ ID: id, FromUserID: fromUserID, FromNick: fromNick, Target: target, Type: msgType, Body: body, } s.Hydrate(m) return m, nil } // QueueMessage adds a message to a user's delivery queue. func (s *Database) QueueMessage( ctx context.Context, userID, messageID string, ) (*models.MessageQueueEntry, error) { res, err := s.db.ExecContext(ctx, `INSERT INTO message_queue (user_id, message_id) VALUES (?, ?)`, userID, messageID, ) if err != nil { return nil, err } entryID, _ := res.LastInsertId() mq := &models.MessageQueueEntry{ ID: entryID, UserID: userID, MessageID: messageID, } s.Hydrate(mq) return mq, nil } // CreateAuthToken inserts a new auth token for a user. func (s *Database) CreateAuthToken( ctx context.Context, token, userID string, ) (*models.AuthToken, error) { _, err := s.db.ExecContext(ctx, `INSERT INTO auth_tokens (token, user_id) VALUES (?, ?)`, token, userID, ) if err != nil { return nil, err } at := &models.AuthToken{Token: token, UserID: userID} s.Hydrate(at) return at, nil } // CreateSession inserts a new session for a user. func (s *Database) CreateSession( ctx context.Context, id, userID string, ) (*models.Session, error) { _, err := s.db.ExecContext(ctx, `INSERT INTO sessions (id, user_id) VALUES (?, ?)`, id, userID, ) if err != nil { return nil, err } sess := &models.Session{ID: id, UserID: userID} s.Hydrate(sess) return sess, nil } // CreateServerLink inserts a new server link. func (s *Database) CreateServerLink( ctx context.Context, id, name, url, sharedKeyHash string, isActive bool, ) (*models.ServerLink, error) { active := 0 if isActive { active = 1 } _, err := s.db.ExecContext(ctx, `INSERT INTO server_links (id, name, url, shared_key_hash, is_active) VALUES (?, ?, ?, ?, ?)`, id, name, url, sharedKeyHash, active, ) if err != nil { return nil, err } sl := &models.ServerLink{ ID: id, Name: name, URL: url, SharedKeyHash: sharedKeyHash, IsActive: isActive, } s.Hydrate(sl) return sl, nil } func (s *Database) connect(ctx context.Context) error { dbURL := s.params.Config.DBURL if dbURL == "" { dbURL = "file:./data.db?_journal_mode=WAL" } s.log.Info("connecting to database", "url", dbURL) d, err := sql.Open("sqlite", dbURL) if err != nil { s.log.Error("failed to open database", "error", err) return err } err = d.PingContext(ctx) if err != nil { s.log.Error("failed to ping database", "error", err) return err } s.db = d s.log.Info("database connected") return s.runMigrations(ctx) } type migration struct { version int name string sql string } func (s *Database) runMigrations(ctx context.Context) error { err := s.bootstrapMigrationsTable(ctx) if err != nil { return err } migrations, err := s.loadMigrations() if err != nil { return err } err = s.applyMigrations(ctx, migrations) if err != nil { return err } s.log.Info("database migrations complete") return nil } func (s *Database) bootstrapMigrationsTable( ctx context.Context, ) error { _, err := s.db.ExecContext(ctx, `CREATE TABLE IF NOT EXISTS schema_migrations ( version INTEGER PRIMARY KEY, applied_at DATETIME DEFAULT CURRENT_TIMESTAMP )`) if err != nil { return fmt.Errorf( "create schema_migrations table: %w", err, ) } return nil } func (s *Database) loadMigrations() ([]migration, error) { entries, err := fs.ReadDir(SchemaFiles, "schema") if err != nil { return nil, fmt.Errorf("read schema dir: %w", err) } var migrations []migration for _, entry := range entries { if entry.IsDir() || !strings.HasSuffix(entry.Name(), ".sql") { continue } parts := strings.SplitN( entry.Name(), "_", minMigrationParts, ) if len(parts) < minMigrationParts { continue } version, err := strconv.Atoi(parts[0]) if err != nil { continue } content, err := SchemaFiles.ReadFile( "schema/" + entry.Name(), ) if err != nil { return nil, fmt.Errorf( "read migration %s: %w", entry.Name(), err, ) } migrations = append(migrations, migration{ version: version, name: entry.Name(), sql: string(content), }) } sort.Slice(migrations, func(i, j int) bool { return migrations[i].version < migrations[j].version }) return migrations, nil } func (s *Database) applyMigrations( ctx context.Context, migrations []migration, ) error { for _, m := range migrations { var exists int err := s.db.QueryRowContext(ctx, "SELECT COUNT(*) FROM schema_migrations WHERE version = ?", m.version, ).Scan(&exists) if err != nil { return fmt.Errorf( "check migration %d: %w", m.version, err, ) } if exists > 0 { continue } s.log.Info( "applying migration", "version", m.version, "name", m.name, ) _, err = s.db.ExecContext(ctx, m.sql) if err != nil { return fmt.Errorf( "apply migration %d (%s): %w", m.version, m.name, err, ) } _, err = s.db.ExecContext(ctx, "INSERT INTO schema_migrations (version) VALUES (?)", m.version, ) if err != nil { return fmt.Errorf( "record migration %d: %w", m.version, err, ) } } return nil }