chat/internal/db/db.go

// Package db provides database access and migration management.
package db

import (
	"context"
	"database/sql"
	"embed"
	"fmt"
	"io/fs"
	"log/slog"
	"sort"
	"strconv"
	"strings"
	"time"

	"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 //nolint:gochecknoglobals

// DatabaseParams defines the dependencies for creating a Database.
type DatabaseParams 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 *DatabaseParams
}

// GetDB returns the underlying sql.DB connection.
func (s *Database) GetDB() *sql.DB {
	return s.db
}

// NewChannel creates a Channel model instance with the db reference injected.
func (s *Database) NewChannel(id int64, name, topic, modes string, createdAt, updatedAt time.Time) *models.Channel {
	c := &models.Channel{
		ID:        id,
		Name:      name,
		Topic:     topic,
		Modes:     modes,
		CreatedAt: createdAt,
		UpdatedAt: updatedAt,
	}
	c.SetDB(s)

	return c
}

// New creates a new Database instance and registers lifecycle hooks.
func New(lc fx.Lifecycle, params DatabaseParams) (*Database, error) {
	s := new(Database)
	s.params = &params
	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(ctx context.Context) error {
			s.log.Info("Database OnStop Hook")

			if s.db != nil {
				return s.db.Close()
			}

			return nil
		},
	})

	return s, 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("failed to 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("failed to 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("failed to 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("failed to 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("failed to 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("failed to record migration %d: %w", m.version, err)
		}
	}

	return nil
}