bd362ab384
Five admin endpoints under existing RequireAdmin middleware:
- GET /api/admin/invites — list active + recently-redeemed
- POST /api/admin/invites — generate 24h invite, returns
{token, expires_at, ...}. Audits ActionInviteCreate.
- DELETE /api/admin/invites/{token} — revoke unredeemed invite.
Audits ActionInviteRevoke.
- GET /api/admin/users — list all users (id, username,
display_name, is_admin, created_at).
- PUT /api/admin/users/{id}/admin — toggle is_admin with
last-admin guard. Audits ActionPromoteAdmin / ActionDemoteAdmin.
Last-admin guard counts admins, refuses demotion of the sole
admin with 409 'last_admin'. Race window between count and update
is acceptable for v1 — worst case is 'no admins left,' which the
env-driven bootstrap or CLI reset can recover from. Common path
('admin demotes themselves') is now blocked.
Adds ListUsers, CountAdmins, UpdateUserAdmin sqlc queries to
users.sql.
Tests cover: invite create/list/delete round-trip, non-admin gets
403, user list, promote happy path, last-admin demotion refused,
two-admins demotion allowed.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
340 lines
8.9 KiB
Go
340 lines
8.9 KiB
Go
// Code generated by sqlc. DO NOT EDIT.
|
|
// versions:
|
|
// sqlc v1.31.1
|
|
// source: users.sql
|
|
|
|
package dbq
|
|
|
|
import (
|
|
"context"
|
|
|
|
"github.com/jackc/pgx/v5/pgtype"
|
|
)
|
|
|
|
const countAdmins = `-- name: CountAdmins :one
|
|
SELECT count(*) FROM users WHERE is_admin = true
|
|
`
|
|
|
|
func (q *Queries) CountAdmins(ctx context.Context) (int64, error) {
|
|
row := q.db.QueryRow(ctx, countAdmins)
|
|
var count int64
|
|
err := row.Scan(&count)
|
|
return count, err
|
|
}
|
|
|
|
const countUsers = `-- name: CountUsers :one
|
|
SELECT count(*) FROM users
|
|
`
|
|
|
|
func (q *Queries) CountUsers(ctx context.Context) (int64, error) {
|
|
row := q.db.QueryRow(ctx, countUsers)
|
|
var count int64
|
|
err := row.Scan(&count)
|
|
return count, err
|
|
}
|
|
|
|
const createUser = `-- name: CreateUser :one
|
|
INSERT INTO users (username, password_hash, api_token, is_admin, display_name)
|
|
VALUES ($1, $2, $3, $4, $5)
|
|
RETURNING id, username, password_hash, api_token, is_admin, created_at, subsonic_password, listenbrainz_token, listenbrainz_enabled, display_name
|
|
`
|
|
|
|
type CreateUserParams struct {
|
|
Username string
|
|
PasswordHash string
|
|
ApiToken string
|
|
IsAdmin bool
|
|
DisplayName *string
|
|
}
|
|
|
|
func (q *Queries) CreateUser(ctx context.Context, arg CreateUserParams) (User, error) {
|
|
row := q.db.QueryRow(ctx, createUser,
|
|
arg.Username,
|
|
arg.PasswordHash,
|
|
arg.ApiToken,
|
|
arg.IsAdmin,
|
|
arg.DisplayName,
|
|
)
|
|
var i User
|
|
err := row.Scan(
|
|
&i.ID,
|
|
&i.Username,
|
|
&i.PasswordHash,
|
|
&i.ApiToken,
|
|
&i.IsAdmin,
|
|
&i.CreatedAt,
|
|
&i.SubsonicPassword,
|
|
&i.ListenbrainzToken,
|
|
&i.ListenbrainzEnabled,
|
|
&i.DisplayName,
|
|
)
|
|
return i, err
|
|
}
|
|
|
|
const createUserFirstAdminRace = `-- name: CreateUserFirstAdminRace :one
|
|
INSERT INTO users (username, password_hash, api_token, is_admin, display_name)
|
|
VALUES (
|
|
$1, $2, $3,
|
|
(SELECT NOT EXISTS (SELECT 1 FROM users)),
|
|
$4
|
|
)
|
|
RETURNING id, username, password_hash, api_token, is_admin, created_at, subsonic_password, listenbrainz_token, listenbrainz_enabled, display_name
|
|
`
|
|
|
|
type CreateUserFirstAdminRaceParams struct {
|
|
Username string
|
|
PasswordHash string
|
|
ApiToken string
|
|
DisplayName *string
|
|
}
|
|
|
|
// Inserts a new user; sets is_admin=true ONLY when no users currently
|
|
// exist. The (SELECT NOT EXISTS ...) subquery is evaluated at INSERT
|
|
// time within the same statement, so the result reflects committed
|
|
// state at that moment.
|
|
//
|
|
// Race semantics: two concurrent calls in an empty-users state may
|
|
// both observe "no users" and both insert with is_admin=true. That's
|
|
// benign — having two admins from the gate is fine; what matters is
|
|
// that there's AT LEAST one. If the two calls happened to share the
|
|
// same username, the unique constraint on users.username arbitrates
|
|
// and the second caller's INSERT fails with a unique violation. The
|
|
// caller (registration handler) can retry as a regular non-admin in
|
|
// that case (or surface a "username taken" error to the user).
|
|
func (q *Queries) CreateUserFirstAdminRace(ctx context.Context, arg CreateUserFirstAdminRaceParams) (User, error) {
|
|
row := q.db.QueryRow(ctx, createUserFirstAdminRace,
|
|
arg.Username,
|
|
arg.PasswordHash,
|
|
arg.ApiToken,
|
|
arg.DisplayName,
|
|
)
|
|
var i User
|
|
err := row.Scan(
|
|
&i.ID,
|
|
&i.Username,
|
|
&i.PasswordHash,
|
|
&i.ApiToken,
|
|
&i.IsAdmin,
|
|
&i.CreatedAt,
|
|
&i.SubsonicPassword,
|
|
&i.ListenbrainzToken,
|
|
&i.ListenbrainzEnabled,
|
|
&i.DisplayName,
|
|
)
|
|
return i, err
|
|
}
|
|
|
|
const getListenBrainzConfig = `-- name: GetListenBrainzConfig :one
|
|
SELECT
|
|
u.listenbrainz_token,
|
|
u.listenbrainz_enabled,
|
|
(SELECT MAX(pe.scrobbled_at)::timestamptz
|
|
FROM play_events pe
|
|
WHERE pe.user_id = u.id) AS last_scrobbled_at
|
|
FROM users u
|
|
WHERE u.id = $1
|
|
`
|
|
|
|
type GetListenBrainzConfigRow struct {
|
|
ListenbrainzToken *string
|
|
ListenbrainzEnabled bool
|
|
LastScrobbledAt pgtype.Timestamptz
|
|
}
|
|
|
|
// Returns the user's LB token + enabled flag and the most recent
|
|
// play_events.scrobbled_at for last-scrobbled-at status.
|
|
func (q *Queries) GetListenBrainzConfig(ctx context.Context, id pgtype.UUID) (GetListenBrainzConfigRow, error) {
|
|
row := q.db.QueryRow(ctx, getListenBrainzConfig, id)
|
|
var i GetListenBrainzConfigRow
|
|
err := row.Scan(&i.ListenbrainzToken, &i.ListenbrainzEnabled, &i.LastScrobbledAt)
|
|
return i, err
|
|
}
|
|
|
|
const getUserByAPIToken = `-- name: GetUserByAPIToken :one
|
|
SELECT id, username, password_hash, api_token, is_admin, created_at, subsonic_password, listenbrainz_token, listenbrainz_enabled, display_name FROM users WHERE api_token = $1
|
|
`
|
|
|
|
func (q *Queries) GetUserByAPIToken(ctx context.Context, apiToken string) (User, error) {
|
|
row := q.db.QueryRow(ctx, getUserByAPIToken, apiToken)
|
|
var i User
|
|
err := row.Scan(
|
|
&i.ID,
|
|
&i.Username,
|
|
&i.PasswordHash,
|
|
&i.ApiToken,
|
|
&i.IsAdmin,
|
|
&i.CreatedAt,
|
|
&i.SubsonicPassword,
|
|
&i.ListenbrainzToken,
|
|
&i.ListenbrainzEnabled,
|
|
&i.DisplayName,
|
|
)
|
|
return i, err
|
|
}
|
|
|
|
const getUserByID = `-- name: GetUserByID :one
|
|
SELECT id, username, password_hash, api_token, is_admin, created_at, subsonic_password, listenbrainz_token, listenbrainz_enabled, display_name FROM users WHERE id = $1
|
|
`
|
|
|
|
func (q *Queries) GetUserByID(ctx context.Context, id pgtype.UUID) (User, error) {
|
|
row := q.db.QueryRow(ctx, getUserByID, id)
|
|
var i User
|
|
err := row.Scan(
|
|
&i.ID,
|
|
&i.Username,
|
|
&i.PasswordHash,
|
|
&i.ApiToken,
|
|
&i.IsAdmin,
|
|
&i.CreatedAt,
|
|
&i.SubsonicPassword,
|
|
&i.ListenbrainzToken,
|
|
&i.ListenbrainzEnabled,
|
|
&i.DisplayName,
|
|
)
|
|
return i, err
|
|
}
|
|
|
|
const getUserByUsername = `-- name: GetUserByUsername :one
|
|
SELECT id, username, password_hash, api_token, is_admin, created_at, subsonic_password, listenbrainz_token, listenbrainz_enabled, display_name FROM users WHERE username = $1
|
|
`
|
|
|
|
func (q *Queries) GetUserByUsername(ctx context.Context, username string) (User, error) {
|
|
row := q.db.QueryRow(ctx, getUserByUsername, username)
|
|
var i User
|
|
err := row.Scan(
|
|
&i.ID,
|
|
&i.Username,
|
|
&i.PasswordHash,
|
|
&i.ApiToken,
|
|
&i.IsAdmin,
|
|
&i.CreatedAt,
|
|
&i.SubsonicPassword,
|
|
&i.ListenbrainzToken,
|
|
&i.ListenbrainzEnabled,
|
|
&i.DisplayName,
|
|
)
|
|
return i, err
|
|
}
|
|
|
|
const listUsers = `-- name: ListUsers :many
|
|
SELECT id, username, display_name, is_admin, created_at
|
|
FROM users
|
|
ORDER BY created_at DESC
|
|
`
|
|
|
|
type ListUsersRow struct {
|
|
ID pgtype.UUID
|
|
Username string
|
|
DisplayName *string
|
|
IsAdmin bool
|
|
CreatedAt pgtype.Timestamptz
|
|
}
|
|
|
|
// Admin user-management list. Sort newest-first.
|
|
func (q *Queries) ListUsers(ctx context.Context) ([]ListUsersRow, error) {
|
|
rows, err := q.db.Query(ctx, listUsers)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
defer rows.Close()
|
|
var items []ListUsersRow
|
|
for rows.Next() {
|
|
var i ListUsersRow
|
|
if err := rows.Scan(
|
|
&i.ID,
|
|
&i.Username,
|
|
&i.DisplayName,
|
|
&i.IsAdmin,
|
|
&i.CreatedAt,
|
|
); err != nil {
|
|
return nil, err
|
|
}
|
|
items = append(items, i)
|
|
}
|
|
if err := rows.Err(); err != nil {
|
|
return nil, err
|
|
}
|
|
return items, nil
|
|
}
|
|
|
|
const setListenBrainzEnabled = `-- name: SetListenBrainzEnabled :exec
|
|
UPDATE users
|
|
SET listenbrainz_enabled = $2
|
|
WHERE id = $1
|
|
`
|
|
|
|
type SetListenBrainzEnabledParams struct {
|
|
ID pgtype.UUID
|
|
ListenbrainzEnabled bool
|
|
}
|
|
|
|
func (q *Queries) SetListenBrainzEnabled(ctx context.Context, arg SetListenBrainzEnabledParams) error {
|
|
_, err := q.db.Exec(ctx, setListenBrainzEnabled, arg.ID, arg.ListenbrainzEnabled)
|
|
return err
|
|
}
|
|
|
|
const setListenBrainzToken = `-- name: SetListenBrainzToken :exec
|
|
UPDATE users
|
|
SET listenbrainz_token = $2,
|
|
listenbrainz_enabled = CASE WHEN COALESCE($2, '') = '' THEN FALSE ELSE listenbrainz_enabled END
|
|
WHERE id = $1
|
|
`
|
|
|
|
type SetListenBrainzTokenParams struct {
|
|
ID pgtype.UUID
|
|
ListenbrainzToken *string
|
|
}
|
|
|
|
func (q *Queries) SetListenBrainzToken(ctx context.Context, arg SetListenBrainzTokenParams) error {
|
|
_, err := q.db.Exec(ctx, setListenBrainzToken, arg.ID, arg.ListenbrainzToken)
|
|
return err
|
|
}
|
|
|
|
const setSubsonicPassword = `-- name: SetSubsonicPassword :exec
|
|
UPDATE users SET subsonic_password = $2 WHERE id = $1
|
|
`
|
|
|
|
type SetSubsonicPasswordParams struct {
|
|
ID pgtype.UUID
|
|
SubsonicPassword *string
|
|
}
|
|
|
|
// Stores (or clears with NULL) the per-user Subsonic legacy credential used
|
|
// for t/s and p auth on /rest/*. Must be plaintext; see migration 0003.
|
|
func (q *Queries) SetSubsonicPassword(ctx context.Context, arg SetSubsonicPasswordParams) error {
|
|
_, err := q.db.Exec(ctx, setSubsonicPassword, arg.ID, arg.SubsonicPassword)
|
|
return err
|
|
}
|
|
|
|
const updateUserAdmin = `-- name: UpdateUserAdmin :one
|
|
UPDATE users
|
|
SET is_admin = $2
|
|
WHERE id = $1
|
|
RETURNING id, username, password_hash, api_token, is_admin, created_at, subsonic_password, listenbrainz_token, listenbrainz_enabled, display_name
|
|
`
|
|
|
|
type UpdateUserAdminParams struct {
|
|
ID pgtype.UUID
|
|
IsAdmin bool
|
|
}
|
|
|
|
// Sets is_admin to the given value. Returns the updated row so the
|
|
// handler can echo it back to the caller.
|
|
func (q *Queries) UpdateUserAdmin(ctx context.Context, arg UpdateUserAdminParams) (User, error) {
|
|
row := q.db.QueryRow(ctx, updateUserAdmin, arg.ID, arg.IsAdmin)
|
|
var i User
|
|
err := row.Scan(
|
|
&i.ID,
|
|
&i.Username,
|
|
&i.PasswordHash,
|
|
&i.ApiToken,
|
|
&i.IsAdmin,
|
|
&i.CreatedAt,
|
|
&i.SubsonicPassword,
|
|
&i.ListenbrainzToken,
|
|
&i.ListenbrainzEnabled,
|
|
&i.DisplayName,
|
|
)
|
|
return i, err
|
|
}
|