amsterdam/database/conference.go

/*
 * Amsterdam Web Communities System
 * Copyright (c) 2025 Erbosoft Metaverse Design Solutions, All Rights Reserved
 *
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at https://mozilla.org/MPL/2.0/.
 */
// The database package contains database management and storage logic.
package database

import (
	"fmt"
	"sync"
	"time"

	lru "github.com/hashicorp/golang-lru"
)

// Conference struct is the top-level structure for a conference.
type Conference struct {
	Mutex       sync.Mutex
	ConfId      int32      `db:"confid"`
	CreateDate  time.Time  `db:"createdate"`
	LastUpdate  *time.Time `db:"lastupdate"`
	ReadLevel   uint16     `db:"read_lvl"`
	PostLevel   uint16     `db:"post_lvl"`
	CreateLevel uint16     `db:"create_lvl"`
	HideLevel   uint16     `db:"hide_lvl"`
	NukeLevel   uint16     `db:"nuke_lvl"`
	ChangeLevel uint16     `db:"change_lvl"`
	DeleteLevel uint16     `db:"delete_lvl"`
	TopTopic    int16      `db:"top_topic"`
	Name        string     `db:"name"`
	Description *string    `db:"descr"`
	IconUrl     *string    `db:"icon_url"`
	Color       *string    `db:"color"`
}

type ConferenceSettings struct {
	ConfId       int32      `db:"confid"`
	Uid          int32      `db:"uid"`
	DefaultPseud *string    `db:"default_pseud"`
	LastRead     *time.Time `db:"last_read"`
	LastPost     *time.Time `db:"last_post"`
}

// conferenceCache is the cache for Conference objects.
var conferenceCache *lru.TwoQueueCache = nil

// getCommunityMutex is a mutex on AmGetCommunity.
var getConferenceMutex sync.Mutex

// conferenceAliasMap stores alias mappings.
var conferenceAliasMap sync.Map

// init initializes the conference cache.
func init() {
	var err error
	conferenceCache, err = lru.New2Q(100)
	if err != nil {
		panic(err)
	}
}

// Aliases returns the list of aliases for this conference.
func (c *Conference) Aliases() ([]string, error) {
	rs, err := amdb.Query("SELECT alias FROM confalias WHERE confid = ? ORDER BY alias", c.ConfId)
	if err != nil {
		return nil, err
	}
	rc := make([]string, 0, 5)
	for rs.Next() {
		var a string
		rs.Scan(&a)
		rc = append(rc, a)
	}
	return rc, nil
}

// AliasesQ returns the list of aliases for this conference, quietly.
func (c *Conference) AliasesQ() []string {
	rc, _ := c.Aliases()
	return rc
}

// Hosts returns the list of users that host this conference.
func (c *Conference) Hosts() ([]*User, error) {
	rs, err := amdb.Query("SELECT uid FROM confmember WHERE confid = ? AND granted_lvl = ?",
		c.ConfId, AmRole("Conference.Host").Level())
	if err != nil {
		return nil, err
	}
	rc := make([]*User, 0, 5)
	for rs.Next() {
		var uid int32
		rs.Scan(&uid)
		u, err := AmGetUser(uid)
		if err == nil {
			rc = append(rc, u)
		}
	}
	return rc, nil
}

// Hosts returns the list of users that host this conference, quietly.
func (c *Conference) HostsQ() []*User {
	rc, _ := c.Hosts()
	return rc
}

// Membership returns a membership flag and granted level for the user in this conference.
func (c *Conference) Membership(u *User) (bool, uint16, error) {
	rs, err := amdb.Query("SELECT granted_lvl FROM confmember WHERE confid = ? AND uid = ?", c.ConfId, u.Uid)
	if err != nil {
		return false, 0, err
	}
	if rs.Next() {
		var level uint16
		rs.Scan(&level)
		return true, level, nil
	}
	return false, 0, nil
}

/* TestPermission is shorthand that tests if a user has a permission with respect to the conference.
 * Parameters:
 *     user - The user to be checked.
 *     perm - The permission to be tested.
 * Returns:
 *     true if the user has the permission, false if not.
 *     Standard Go error status.
 */
func (c *Conference) TestPermission(perm string, level uint16) bool {
	switch perm {
	case "Conference.Read":
		return level >= c.ReadLevel
	case "Conference.Post":
		return level >= c.PostLevel
	case "Conference.Create":
		return level >= c.CreateLevel
	case "Conference.Hide":
		return level >= c.HideLevel
	case "Conference.Nuke":
		return level >= c.NukeLevel
	case "Conference.Change":
		return level >= c.ChangeLevel
	case "Conference.Delete":
		return level >= c.DeleteLevel
	default:
		return AmTestPermission(perm, level)
	}
}

/* AmGetConference returns a conference given its ID.
 * Parameters:
 *     id - The ID of the conference.
 * Returns:
 *     Pointer to the conference, or nil.
 *     Standard Go error status.
 */
func AmGetConference(id int32) (*Conference, error) {
	var err error = nil
	getConferenceMutex.Lock()
	defer getConferenceMutex.Unlock()
	rc, ok := conferenceCache.Get(id)
	if !ok {
		var dbdata []Conference
		err = amdb.Select(&dbdata, "SELECT * from confs where confid = ?", id)
		if err != nil {
			return nil, err
		}
		if len(dbdata) == 0 {
			return nil, fmt.Errorf("conference with ID %d not found", id)
		} else if len(dbdata) > 1 {
			return nil, fmt.Errorf("AmGetConference(%d): too many responses(%d)", id, len(dbdata))
		}
		rc = &(dbdata[0])
		conferenceCache.Add(id, rc)
	}
	return rc.(*Conference), err
}

/* AmGetConferenceByAlias returns a conference given its alias.
 * Parameters:
 *     alias - The alias to look up.
 * Returns:
 *     Pointer to the conference, or nil.
 *     Standard Go error status.
 */
func AmGetConferenceByAlias(alias string) (*Conference, error) {
	confid, ok := conferenceAliasMap.Load(alias)
	if !ok {
		rs, err := amdb.Query("SELECT confid FROM confalias WHERE alias = ?", alias)
		if err != nil {
			return nil, err
		}
		if !rs.Next() {
			return nil, fmt.Errorf("alias not found: %s", alias)
		}
		rs.Scan(&confid)
		conferenceAliasMap.Store(alias, confid)
	}
	return AmGetConference(int32(confid.(int)))
}

/* AmGetCommunityConferences returns all conferences for a given community.
 * Parameters:
 *     cid - Community ID to get conferences for.
 *     showHidden - true to show hidden conferences.
 * Returns:
 *     Array containing the COnference pointers, or nil.
 *     Stanbard Go error status.
 */
func AmGetCommunityConferences(cid int32, showHidden bool) ([]*Conference, error) {
	q := ""
	if !showHidden {
		q = " AND x.hide_list = 0"
	}
	rs, err := amdb.Query(`SELECT x.confid FROM commtoconf x, confs c WHERE x.confid = c.confid
		AND x.commid = ?`+q+" ORDER BY x.sequence, c.name", cid)
	if err != nil {
		return nil, err
	}
	rc := make([]*Conference, 0, 6)
	for rs.Next() {
		var confid int32
		rs.Scan(&confid)
		conf, err := AmGetConference(confid)
		if err == nil {
			rc = append(rc, conf)
		}
	}
	return rc, nil
}